About Tableau Catalog

Data is increasing in volume, formats, and importance leading to more complex environments. With the rapid pace that data changes, it can be hard to keep track of that data and how it's being used in such complex environments. At the same time, more users need to access more of that data in more places, and it’s difficult for users to find the right data. Ultimately, this causes a lack of trust in the data because people question whether they’re using the right source or if it’s up to date.

Tableau Catalog integrates features like lineage, impact analysis, data dictionary, data quality warnings, and search into your Tableau applications, helping solve these problems differently from a stand-alone catalog. It focuses on both IT and the end user so that everyone using Tableau Server or Tableau Online has more visibility and trust into the data, while also enabling more discoverability. Tableau Catalog builds a catalog out of the Tableau content being used by your organization, enabling comprehensive functionality like the following:

  • Impact analysis and lineage.
    • You can see the workbooks and other Tableau content that depend on particular columns or fields from tables or data sources you manage. When you need to make changes to your data, you can notify the impacted Tableau authors using email.
    • As a workbook author, you can use lineage to trace the fields that your workbook depends on.
    • As a user, when you use a Tableau visualization, you can see where the data came from that was used to create the view.
  • Curation and trust. As a data steward, you can add helpful metadata, like descriptions and certification, so that users find the right data. You can set data quality warnings, view data details on the Data Details pane, certify assets, and remove assets from the catalog.
  • Data discovery. You can use Tableau Catalog to search for databases, tables, and data sources to analyze in Tableau and connect to them from the search results.

Starting in 2019.3, Tableau Catalog is available in the Data Management Add-on to Tableau Server and Tableau Online. When the product key is active and enabled, the catalog features described above are integrated into the product you're using, so you can work with the data where you find it.

How Tableau Catalog works

Tableau Catalog discovers and indexes all the content on your site—workbooks, data sources, sheets, and flows—to gather metadata about the content. From the metadata, databases and tables (also referred to as external assets) are identified. Knowing the relationships between the content and the external assets enables Tableau to display the lineage of the content and assets. Tableau Catalog also enables users to connect to external assets using Tableau Server or Tableau Online.

For information about how you can use Tableau Catalog to support data governance in your organization, see Governance in Tableau(Link opens in a new window) in the Tableau Blueprint Help.

Key Tableau Catalog terms

  • Metadata. Information about the data.
  • Tableau content. Content created in Tableau such as workbooks, data sources, and flows.
  • External assets. The metadata about the databases and tables used by the Tableau content published to Tableau Server or Tableau Online.

License Tableau Catalog

Tableau Catalog is licensed through the Data Management Add-on. For information about how Data Management Add-on licensing works, see License the Data Management Add-on.

Enable Tableau Catalog

After Tableau Server or Tableau Online is licensed with the Data Management Add-on, you can enable Tableau Catalog by doing one of the following tasks:

  • For Tableau Online, no action necessary. Tableau Catalog is on by default, configured to use derived permissions, and ready to use. For more information about derived permissions, see the Permissions on metadata topic.
  • For Tableau Server, the Server admin must first enable the Tableau Metadata API using the tsm maintenance metadata-services command. For more information, see Enable Tableau Catalog.

    After the Metadata API is enabled, Tableau Catalog is on by default, configured to use derived permissions, and ready to use. For more information about derived permissions, see the Permissions on metadata topic.

Features and functionality

To learn more about the features you can use with Tableau Catalog, see the following Help articles:

Data discovery

Curation and trust

Lineage and impact analysis

Developer resources

You can use the Tableau Metadata API(Link opens in a new window) to programmatically query metadata from the content published to Tableau Server or Tableau Online. The Metadata API is fast and flexible and is best when you are looking to find out specific information about the relationship between metadata and its structures.

In addition to the Metadata API, you can use metadata methods in the Tableau Server REST API to programmatically update certain metadata. For more information about metadata methods , see Metadata Methods in the Tableau Server REST API.


Thanks for your feedback! There was an error submitting your feedback. Please try again.