The Atlan glossary allows you to add new terms and categories, search for existing glossary definitions, and archive old ones. You can also nest terms under categories and subcategories to create a glossary hierarchy.
Set up a glossary
To define the relevant terms and categories for your data assets, you will first need to set up a glossary.
To create a glossary:
- From the left menu of any screen in Atlan, click Glossary and then click Get started.
- In the Create new glossary dialog, enter the following details:
- For Glossary name, enter a name for your glossary — for example,
Finance
. The character limit for a glossary name is 80 characters. - In the top right, Draft is set as the default certificate. To change the certificate, click the dropdown arrow and select the certificate you'd like to apply to your glossary.
- Click the glossary icon to personalize the icon for your glossary.
- For Description, write a short or detailed description for your glossary — size limit for description values is 32766 bytes.
- For Add owners, add yourself or anyone else in your team as owners of the glossary.
- Click Create to add your glossary.
- For Glossary name, enter a name for your glossary — for example,
- (Optional) From the top right of the glossary profile:
- Click the user avatars to view a list of recently visited users, total views on your glossary, total number of unique visitors, and total views by user.
- Use the days filter to filter glossary views and user activity in the last 7, 30, and 90 days.
- This feature is turned on by default — admins can turn off user activity.
- Click the star button to star your glossary.
- Click the clipboard icon to copy the link for your glossary.
- Click the pencil icon to edit the glossary name, description, and icon.
- Click the Slack or Teams icon to share directly on a Slack or Microsoft Teams channel.
- Click the bell icon to enable Slack or Microsoft Teams notifications for glossary updates in Atlan.
- Click the 3-dot icon and then:
- Click Add announcement to add an announcement to your glossary.
- Click Bulk upload terms to bulk upload terms to your glossary.
- Click Export to export nested categories and terms within a glossary to spreadsheets.
- Click Archive to archive the glossary.
- Click the user avatars to view a list of recently visited users, total views on your glossary, total number of unique visitors, and total views by user.
Your glossary is now ready for you to start adding terms and categories! 🎉
Add new glossary terms
Terms are the building blocks of your glossary. While defining a new glossary term, add as much information as possible for your term so that your team fully understands how to use it.
To add a new glossary term:
- On the Glossary page, click the + icon next to All glossaries and then click Add term from the dropdown.
- In the Create new term dialog, enter the following details:
- For Select glossary, select a glossary for your term. In this example, we'll select the
Finance
glossary. - For Term name, enter a name for your term — for example,
Credit Score
. The character limit for a term name is 80 characters. - In the top right, Draft is set as the default certificate. To change the certificate, click the dropdown arrow and select the certificate you'd like to apply to your term.
- (Optional) For Alias, add an alias to your term.
- For Description, write a short or detailed description for your term — size limit for description values is 32766 bytes.
- For Add owners, add yourself or anyone else in your team as owners of the glossary.
- (Optional) Turn on Create multiple to create more terms from the same dialog.
- Click Create to add your term.
- For Select glossary, select a glossary for your term. In this example, we'll select the
- (Optional) From the top right of the term profile:
- Click the user avatars to view a list of recently visited users, total views on your term, total number of unique visitors, and total views by user.
- Use the days filter to filter views and user activity in the last 7, 30, and 90 days.
- This feature is turned on by default — admins can turn off user activity.
- Click the star button to star your term.
- Click the clipboard icon to copy the link for your term.
- Click the pencil icon to edit the term name and description or add an alias to your term.
- Click the Slack or Teams icon to share directly on a Slack or Microsoft Teams channel.
- Click the bell icon to enable Slack or Microsoft Teams notifications for glossary updates in Atlan.
- Click the 3-dot icon to add an announcement or archive the term.
- Click the user avatars to view a list of recently visited users, total views on your term, total number of unique visitors, and total views by user.
Update your glossary terms
You can also add a term to your glossary without attaching a certificate or adding an owner at first. Once you have completed adding a term, navigate to the sidebar next to the term profile:
- Click + under Owners to assign owners for a term.
- Click Draft to update the certificate for a term. Choose from four certificate options — Draft, Verified, Deprecated, and No certificate.
- Click + under Tags to classify the key characteristics of your term and configure tag propagation for linked assets.
- Click + under Categories to assign a term to a particular category.
- Click + under any of the associated term options to create relationships between terms.
Add new glossary categories
You can add categories to your glossary to better organize your terms and create a hierarchy of information.
To add a category to your glossary:
- On the Glossary page, next to the name of your glossary in the left, click the three horizontal dots icon and then click Add category.
- In the Create new category dialog, enter the following details:
- For Category name, enter a name for your category — for example,
Personal Finance
. The character limit for a category name is 80 characters. - In the top right, Draft is set as the default certificate. To change the certificate, click the dropdown arrow and select the certificate you'd like to apply to your category.
- For Description, write a short or detailed description for your category — size limit for description values is 32766 bytes.
- For Add owners, add yourself or anyone else in your team as owners of the glossary.
- (Optional) Turn on Create multiple to create more categories from the same dialog.
- Click Create to add your category.
- For Category name, enter a name for your category — for example,
- Next to the category name in the left menu, click the three horizontal dots icon and then add new terms or subcategories to your category.
- (Optional) From the top right of the category profile:
- Click the user avatars to view a list of recently visited users, total views on your category, total number of unique visitors, and total views by user.
- Use the days filter to filter views and user activity in the last 7, 30, and 90 days.
- This feature is turned on by default — admins can turn off user activity.
- Click the star button to star your category.
- Click the clipboard icon to copy the link for your term.
- Click the pencil icon to edit the category name and description.
- Click the Slack or Teams icon to share directly on a Slack or Microsoft Teams channel.
- Click the bell icon to enable Slack or Microsoft Teams notifications for glossary updates in Atlan.
- Click the 3-dot icon and then:
- Click Add announcement to add an announcement to your category.
- Click Export to export nested terms within a category to spreadsheets.
- Click Archive to archive the category.
- Click the user avatars to view a list of recently visited users, total views on your category, total number of unique visitors, and total views by user.
Move terms and categories
You can move terms and categories within and across glossaries to better organize your business context. Move terms to a different category or create subcategories within the same glossary or across your glossaries in Atlan.
You will need the following permissions:
- Moving a term or category from one glossary to another — read, update, and delete permissions on both glossaries.
- Moving a term or category within the same glossary — update permission on the glossary you want to reorganize.
To move an existing term or category:
- From the left menu of any screen in Atlan, click Glossary.
- In the left menu of the Glossary page, you can either:
- Drag and drop a term or category into the relevant category within the same or a different glossary. In the popup, click Confirm to confirm the changes.
- To the right of the term or category name, click the three dots icon and then click Move to. In the Move to dialog, select a relevant category within the same or a different glossary and then click Move to confirm the changes.
Search for glossary terms
There are two ways to search for glossary terms:
- In the left panel of the Glossary page, type the name of your term in the search bar and select your preferred option from the search results.
- Click the > icon preceding the name of a category to expand the full list of nested terms in that category.
Add READMEs to your assets
For glossaries, terms, and categories, the asset profile provides a helpful summary. For example, the Linked assets section displays all the data assets that are linked to a particular term. This is also where you can add a README.
The secret to making your glossary really useful is to provide as much information as possible. Adding a README will allow you to state your objectives for defining a glossary unit in greater detail.
Inspect glossary terms and categories
The navigation bar to the right of the asset profile provides high-level information about the glossary item you are looking at. Here's what you can view:
- Overview shows key characteristics of a glossary term or category and helps you understand its relationship to other items in a glossary.
- Activity displays the changelog for your glossary items. For instance, you can find out who updated a term and when.
- Resources are links to internal or external URLs that can help your team better understand your glossary items. You can add links from GitHub, Google Docs, Google Sheets, or more as resources to your glossary item to provide additional context.
- Requests for a particular glossary item can be filtered by their status, such as Pending, Approved, and Rejected.
- Properties show the unique identification number of a glossary item and other properties.
- Integrations show Slack or Teams messages and Jira tickets pertaining to a particular glossary item.
Add associated terms
In order to inter-relate your terms, you will first need to set up a glossary and then add terms.
To add relationships between terms:
- From the left menu on any screen, click Glossary.
- Under Glossary in the left menu, click the name of your glossary.
- Under the glossary name, click the category in which your term is nested and then click the term you would like to enrich with an associated term.
- In the Overview tab of the term sidebar to the right, under Associated terms, click + to add relationships to your term. In the Associate terms dialog, configure the following:
- To select a term relationship:
- Click Related to to add a term that is related in some way.
- Click Recommended to add a standard form of use for the term.
- Click Synonyms to add a term that is similar in meaning.
- Click Antonyms to add a term that is opposite in meaning.
- Click Translates to to add a translated version of the term.
- Click Valid values for to add applicable values for the term.
- Click Classifies to add an umbrella category for the term.
- Click Classified By to add a term that falls under the purview of the term in use.
- For Select terms, select existing terms to associate.
- Click Associate terms to confirm your selections. The interrelated terms will reflect the relationships automatically in the term profile and sidebar.
- To select a term relationship:
- (Optional) Under Associated terms in the term profile, you can view a visual representation of your term relationships:
- Click any term attribute to focus on that specific term relationship.
- Click the minus or plus icons to zoom out or zoom in on the graph, respectively.
- Click the expand icon to enlarge the graph.