Flag certified and deprecated data

Beta

This feature is in Beta.

This page shows how to apply system tags to Unity Catalog securable objects to mark them as certified or deprecated.

Certified and deprecated system tags

The certified and deprecated system tags allow users to label Unity Catalog securable objects, such as catalogs, schemas, and tables, with indicators of data quality or lifecycle status. These system tags help organizations enforce governance, improve data discoverability, and increase trust in analytics and AI applications. These tags are displayed next to object names in Catalog Explorer, and influence how data appears in notebooks and the SQL editor.

The certified and deprecated tags are predefined system tags managed by Databricks:

• system.Certified: Indicates that a data asset has met internal standards for accuracy, completeness, and trust.

  

• system.Deprecated: Warns that a data asset is outdated, no longer reliable, or should not be used in new workflows.

  

Supported securable types

You can apply certification or deprecation tags to the following :[UC] securable objects:

• Catalogs
• Schemas
• Tables
• Views
• Volumes
• Registered models

Permissions required

Certification and deprecation are system tags governed by system tag policies. To apply them to data objects, you must have the ASSIGN permission on the system.Certified or system.Deprecated tag policy. See Manage tag policy permissions.

To add tags to Unity Catalog securable objects, you must own the object or have all of the following privileges:

• APPLY TAG on the object
• USE SCHEMA on the object's parent schema
• USE CATALOG on the object's parent catalog

Apply certification or deprecation tags

After permissions are set, users can apply or remove the tags using either Catalog Explorer or SQL.

Catalog Explorer

1. Go to Catalog Explorer in your workspace.

2. Navigate to a data object (for example, a schema).

3. Next to No certification set, click the pencil icon .

   

4. Select Certified or Deprecated or both.

   

5. Click Save.

You can update or remove the status at any time.

SQL

SQL

-- Example: Apply Certification tag
ALTER TABLE main.sales.transactions
SET TAGS ('system.Certified' = 'true');

-- Example: Apply Deprecation tag
ALTER VIEW main.sales.old_summary
SET TAGS ('system.Deprecated' = 'true');