Glossary

The glossary helps you keep key business terms centralized and common across the organization.

All users can view Glossary terms in the Docs tab, and additionally can filter to Glossary terms under All Documents.

Data Managers and Admins can see and create new glossary terms directly in the UI by clicking on Create New Doc > Glossary in the left navigation, or can upload a CSV to create and update terms in bulk.

When creating and updating Glossary terms via CSV upload, note the expected format is

• Columns in the CSV:

  • parent_guid - The guid of the parent document for this glossary term, which is used to set the hierarchy of documents. If empty, the glossary term will be created at the top level with no nesting.

  • guid - The guid of the glossary term. If no guid is given in an import, a new term will be created. If the guid is present, that term will be updated.

  • name - The name of the glossary term.

  • description - The description of the glossary term, in markdown format. Note: this does not support @ mentions format within Select Star.

  • business_owner - The business owner of the term. For users this is the user email, for teams this is the team name.If no owner is given when creating a new term, the user performing the upload will be set as the owner.

  • technical_owner - The technical owner of the term. For users this is the user email, for teams this is the team name.If no owner is given when creating a new term, the user performing the upload will be set as the owner.

  • tags - The tags associated with the glossary term, as a comma separated list.

Stakeholders can also use the Discussion tab to ask questions or make comments about the glossary term.

The owners will be notified of any comments. By default, both the Business and Technical Owner of a glossary term are set to the person who created it. Data Managers and Admins can change the Owners as needed, and even apply Tags by clicking the 🏷 icon next to the title.

Useful links:

• Glossary terms API documentation: https://api.production.selectstar.com/docs/#tag/terms