# Adding Terms and Linked Assets

Users can link tables and columns from the data catalog directly to glossary terms. This feature allows users to quickly identify which tables contain the data needed for specific metrics. Additionally, any open incidents related to these linked tables are displayed alongside, alerting users to potential issues. This ensures informed decision-making and data integrity when using these assets.

* Step 1: You will need a Term first to add links to assets.
* Navigate to the Catalog → Glossary page.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-73a72a0bfb00ef52a43eba47530969f0999ed1c1%2Fimage.png?alt=media" alt="" width="347"><figcaption></figcaption></figure>

* Step 2: Click on Add Term.
* You can add term under Glossary and Category.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-e8f5589357f79b28dd34778250eb766a6c99dc5e%2Fimage.png?alt=media" alt="" width="347"><figcaption><p>Glossary</p></figcaption></figure>

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-61e1357790fbfcbc76127150901747c6a8ebedf4%2Fimage%20(366).png?alt=media" alt="" width="349"><figcaption><p>Category</p></figcaption></figure>

* Step 3: Fill in the name and description to add a term. A reviewer/approver will need to be selected at the bottom (or it is marked as approved instantly).

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-25c7522920f2ea919d8e6b9e48130d4111163fae%2Fimage.png?alt=media" alt=""><figcaption><p>Name, Description</p></figcaption></figure>

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-b639e77d7f87e1c5e0049a632061488724e5d737%2Fimage.png?alt=media" alt=""><figcaption><p>Data Owners, Business Owners, Related Terms, Reviewer</p></figcaption></figure>

* Step 4: Once term is added, you can click on the created term.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-9e0de6c84c52d3c267f0c65d803a037ba68e8f2e%2Fimage.png?alt=media" alt="" width="341"><figcaption></figcaption></figure>

* Step 5: In the Term, click on the tab Linked Assets. Click on `Make Changes` and a banner will appear under Glossary tab.

{% hint style="info" %}
Adding, editing or removing linked assets will also require the approval workflow to take effect.
{% endhint %}

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-2006af6224101918d50142cb9a341072039b5b16%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-a3a509b75c7c96c610086964a68e8cd61f6a15af%2Fimage.png?alt=media" alt=""><figcaption><p>a banner is appeared upon clicking Make Changes</p></figcaption></figure>

* Step 6: Search and add the Asset/Data Product/Data Asset to be linked. You can filter the list by asset types and sources.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-1979099ef6fb28eabbe4e07a4a1a73b8e0c46424%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Step 7: Once the Asset/Data Product/Data Asset has been selected, click on `Link these assets`

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-19064ccabbd2bcc20ee23e4fa0cd10da7e6a929c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Step 8: next, the selected Asset/Data Product/Data Asset will be displayed under Linked Assets subtab.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-f77252ef2abdbc610a1b958b233f04773cd39995%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Step 9: Before completing the process of adding linked assets, you will need to submit the request for changes by selecting a reviewer/approver or `Mark as approved immediately`
* Once the request is approved, the linked assets will show up in the Linked Assets tab in the Term

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-e21e777434cf828ee936ba0c00130bb047da623c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-e16bec37a7183eecbb0e545094081aa3c81a2b2c%2Fimage.png?alt=media" alt=""><figcaption><p>an asset is successfully linked</p></figcaption></figure>

### Deleting Linked Assets

* Step 1: Navigate to **Linked Assets** subtab under any glossary.
* Step 2: Click on **Make Changes**.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-8df6fd7a4b48499497fcfe304d2bab0cdb3e2345%2Fimage%20(386).png?alt=media" alt=""><figcaption><p>Navigating to the Linked Assets subtab and clicking "Make Changes"</p></figcaption></figure>

* Step 3: Click **Request changes** and a banner will appear under Glossary tab and click **Edit linked assets**.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-0fc5867e8a8aaada0055408a002ab712801b15a8%2Fimage.png?alt=media" alt=""><figcaption><p>A banner will appear under the <strong>Glossary</strong> tab</p></figcaption></figure>

* Step 4: Edit Linked Assets form will be displayed.
* Step 5: Click the bin icon 🗑️ and a `Remove` text in red will appear. Click **Link these assets** to proceed with the approval flow.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-28fc23a6e8d5475ccc83f7795133dc17d7543c55%2Fimage.png?alt=media" alt=""><figcaption><p>Edit Linked Assets form with the bin icon 🗑️</p></figcaption></figure>

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-552523a2ffebcf31689e2b19c2bd46eee1889aac%2Fimage.png?alt=media" alt=""><figcaption><p>Edit Linked Assets form with the "Remove" text in red, ready for approval flow</p></figcaption></figure>

{% hint style="info" %}
If you wish to undo the action and not proceed with deleting, click the **←** arrow.
{% endhint %}

* Step 6: The selected assets to be deleted will be displayed as **`Remove`**.
* Step 7: Click on **Request changes** and a modal form will be opened.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-63ecd89da3f9da2c1d1b871641097b08a54ef576%2Fimage.png?alt=media" alt=""><figcaption><p>The "Remove" display for selected asset</p></figcaption></figure>

* Step 8: Submit the request by selecting a reviewer, or mark it as **Approved immediately** and click **Confirm and request changes**.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-b8bab20b61814696a9e138baba4ab832057e23bc%2Fimage.png?alt=media" alt=""><figcaption><p>Submit changes for approval form</p></figcaption></figure>

The linked asset has now been deleted.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-69d3f838ddaa8168998f4189d680c8698e291834%2Fimage.png?alt=media" alt=""><figcaption><p>Confirmation that the linked asset has been deleted.</p></figcaption></figure>

### Deleting Glossary, Category, and Term

**Glossary**

* Step 1: Select any glossary and click on the ellipsis (⋮).
* Step 2: Click **Delete,** and a pop-up will be displayed.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-dcc17e05ac8b10e63274535bb5f85afadeca1384%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Step 3: Type **DELETE** to confirm the deletion and click **Delete this glossary**. The asset will be successfully deleted.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-c8ef9e0d99aad46dcce462389a8833328a1581a1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-63538fa1df74616439f0da11dc0150aed89e96a4%2Fimage.png?alt=media" alt=""><figcaption><p>Confirmation that the glosssary has been deleted</p></figcaption></figure>

#### Category

* Step 1: Click any glossary and select a category under it. Click on the ellipsis (⋮) of the category.
* Step 2: Click **Delete,** and a pop-up will be displayed.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-26ea711539afc682a1fcffebe3f9a197eb07b7a6%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Step 3: Type **DELETE** to confirm the deletion and click **Delete this category**. The asset will be successfully deleted.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-52df22f55f947a845dc5bf5bbf063a806e6f3ebe%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-e235c5aa2b4007b8ec2fcb4ab60fe5e31e9c42e2%2Fimage.png?alt=media" alt=""><figcaption><p>Confirmation that the category has been deleted</p></figcaption></figure>

#### Term

* Step 1: Click a term under any glossary or category. Click on the ellipsis (⋮) of the category.
* Step 2: Click **Delete,** and a pop-up will be displayed.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-05b9480b5b106b591ea9aa27acc5b6c222538a83%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Step 3: Type **DELETE** to confirm the deletion and click **Delete this term**. The asset will be successfully deleted.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-2c1f6296d5f3bb31999dcdeb6c051f777420f81f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-b9de2a2ffb2d47849fe9160220cab5a7079be49e%2Fimage.png?alt=media" alt=""><figcaption><p>Confirmation that the term has been deleted</p></figcaption></figure>

### Linked Terms in Asset Overview

The **Linked Terms** feature in the Asset Overview is available for **Dataset**, **Schema**, and **Source** assets. It displays the count of terms linked to a specific **Asset**, **Table**, or **Column**. The list of linked terms is **clickable**, allowing users to view more details about each term.

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-3e63848b20db2d96f8407203ce780db63819a492%2Fimage.png?alt=media" alt=""><figcaption><p>Linked Terms</p></figcaption></figure>

<figure><img src="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-8e8629c790b5ab12cdae7dd42d9318b7c1fafa5a%2Fimage.png?alt=media" alt="" width="353"><figcaption><p>Asset Overview</p></figcaption></figure>

{% hint style="info" %}
You have the option to move a term to a glossary or category. To do so, please refer to the [Moving Terms to Glossary/Category](https://docs.decube.io/glossary/adding-terms-and-linked-assets/moving-terms-to-glossary-category) document.
{% endhint %}
