Managed attributes in the Microsoft Purview Data Catalog


On April 22, 2024 managed attributes moved to be under the Microsoft Purview Data Catalog feature in the Microsoft Purview portal. Access instructions have been updated.

Managed attributes are user-defined attributes that provide a business or organization level context to an asset. When applied, managed attributes enable data consumers using the data catalog to gain context on the role an asset plays in a business.


Managed attribute: A set of user-defined attributes that provide a business or organization level context to an asset. A managed attribute has a name and a value. For example, 'Department' is an attribute name and “Finance” is its value. Attribute group: A grouping of managed attributes that allow for easier organization and consumption.

Create managed attributes

  1. Open managed attributes in the Microsoft Purview Data Catalog:
  2. Select New. Choose whether you wish to start by creating an attribute group or a managed attribute. Screenshot that shows how to create a new managed attribute or attribute group.
  3. To create an attribute group, enter a name and a description. Screenshot that shows how to create an attribute group.
  4. Managed attributes have a name, attribute group, data type, and associated asset types. They also have a required flag that can only be enabled when created as part of creating a new attribute group. Associated asset types are the data asset types you can apply the attribute to. For example, if you select "Azure SQL Table" for an attribute, you can apply it to Azure SQL Table assets, but not Azure Synapse Dedicated Table assets. Screenshot that shows how to create a managed attribute.
  5. Select Create to save your attribute.

Required managed attributes

When you create a managed attribute as part of a managed attribute group, you can add the required flag. The required flag means that a value must be provided for this managed attribute. When a data asset is edited the required attribute must be filled out before you can close the editor.


  • You can't add the required flag to an existing attribute in editing.
  • You can't add the required flag while creating a new attribute outside of an attribute group. You can only add this flag while creating an attribute group.
  1. Open the data map application and navigate to Managed attributes in the Annotation management section.
  2. Select New and select Attribute group.
  3. Select New attribute.
  4. Fill out your attribute details, and select the Mark as required flag. Screenshot of the mark as required flag on a new attribute being created as a part of a new attribute group.
  5. Select Apply and finish adding other attributes to complete your attribute group.

Expiring managed attributes

In the managed attribute management experience, managed attributes can't be deleted, only expired. Expired attributes can't be applied to any assets and are, by default, hidden in the user experience. By default, expired managed attributes aren't removed from an asset. If an asset has an expired managed attribute applied, it can only be removed, not edited.

Both attribute groups and individual managed attributes can be expired. To mark an attribute group or managed attribute as expired, select the Edit icon.

Screenshot that shows how to edit an attribute group.

Select Mark as expired and confirm your change. Once expired, attribute groups and managed attributes can't be reactivated.

Screenshot that shows the edit an attribute group window.

Apply managed attributes to assets in Microsoft Purview Studio

Managed attributes can be applied in the asset details page in the data catalog. Follow the instructions below to apply a managed attribute.

  1. Navigate to an asset by either searching or browsing the data catalog. Open the asset details page.
  2. Select Edit on the asset's action bar. Screenshot that shows how to edit an asset.
  3. In the managed attributes section of the editing experience, select Add attribute.
  4. Choose the attribute you wish to apply. Attributes are grouped by their attribute group.
  5. Choose the value or values of the applied attribute.
  6. Continue adding more attributes or select Save to apply your changes.

Create managed attributes using APIs

Managed attributes can be programmatically created and applied using the business metadata APIs in Apache Atlas 2.2. For more information, see the Use Atlas 2.2 APIs tutorial.

Searching by managed attributes

Once you have created managed attributes, you can refine your data catalog searches using these attributes.

  1. In a data catalog search, to refine by a managed attribute, first select Add filter at the top of the search.

    Screenshot showing the add filter button highlighted on a search in the Data Catalog.

  2. Select the drop-down, scroll to your list of managed attributes, and select one.

    Screenshot showing the filter dropdown with the list of added managed attributes highlighted.

  3. Select your operator, which will be different based on the kinds of values allowed by the attribute. In this example, we've selected Cost Center, which is a text value, so we can compare Cost Center with the text we'll enter.

    Screenshot showing the filter operator dropdown with the available operators highlighted.

  4. Enter your values and the search will run with your new filter.

Known limitations

Below are the known limitations of the managed attribute feature as it currently exists in Microsoft Purview.

  • Managed attributes can only be deleted if they haven't been applied to any assets.
  • Managed attributes can't be applied via the bulk edit experience.
  • After creating an attribute group, you can't edit the name of the attribute group.
  • After creating a managed attribute, you can't update the attribute name, attribute group or the field type.
  • A managed attribute can only be marked as required during the creation of an attribute group.

Next steps