Skip to content

You are viewing documentation for Immuta version 2021.1.

For the latest version, view our documentation for Immuta SaaS or the latest self-hosted version.

Create and Manage Tags

Audience: Data Governors

Content Summary: This document outlines step-by-step instructions for creating tags and viewing tags on the Governance page.

Additional Tutorials Contents:

  • View Tags
  • Import Tags from External Catalogs

Use Case

Compliance Requirement: Users can only interact with Dev data.

The Governor needs to create tags for the different environments (Dev, Test, and Prod) to identify data and guide Global Policies. Once the tags have been created, they can be used to build policies and applied to data sources and projects.

Create Tags

  1. Click the Governance icon in the left sidebar, and then click the Tags tab.
  2. Click Add Tags in the top right corner.
  3. Complete the Enter tag fields for tags as represented below. Note: The nested tag is optional. Click the delete icon to remove it

    Tags Create 1

  4. Click Save.

Note: Although you should be using Sensitive Data Detection, it is sometimes necessary to create your own tags or import tags from an external catalog.


The Tags tab should now contain the new environment tag set, imported tags from external catalogs, and Discovered tags (when Sensitive Data Detection has been enabled).

Environment Tags

Additional Tutorials

View Tags

  1. Click the Governance icon in the left sidebar, and then click the Tags tab.
  2. A list of all top-level tags will be displayed. Click Expand to view nested tags.
  3. Click the icons in the Actions column to the right of the tags to edit tags, generate tag reports, or delete tags.

Import Tags from External Catalogs

You can pull external tags that you had previously defined in the external catalog (e.g., Collibra, Alation, etc.). Note that you will only be able to pull tags for queryable data sources:

  1. Click the Governance icon in the left sidebar and select the Tags tab.
  2. Click Refresh External Tags.

    Refresh External Tags

Link an External Catalog to a Data Source

External tags will be automatically detected when you create a new data source that originates in an external catalog, or they can be linked directly in the data source here:

Data Source with External Tags

Custom REST Catalog Information

When using custom REST catalogs the GET/dataSource/page/{id} endpoint returns a human-readable information page from the REST catalog for the data source associated with {id}. Immuta provides this as mechanism for allowing the REST catalog to provide additional information about the data source that may not be directly ingested by or visible within Immuta. This link is accessed in the Immuta UI when a user clicks the catalog logo associated with the data source:

REST Catalog Column Link

What's Next

Now that you've created tags, continue to the next page or to this tutorial: Sensitive Data Detection.