## Add custom metadata badges

URL: https://docs.atlan.com/product/capabilities/governance/custom-metadata/how-tos/add-custom-metadata-badges

> Bringing visibility to custom metadata and enriching it with additional context are critical requirements for data teams. Atlan enables you to highlight the most critical custom metadata with badges.

:::warning Who can do this?
 You must be an admin user to be able to add badges for [custom metadata](https://docs.atlan.com/llms/governance/custom-metadata/what-is-custom-metadata/llms.txt).

:::

Bringing visibility to custom metadata and enriching it with additional context are critical requirements for data teams. Atlan enables you to highlight the most critical custom metadata with badges.

Admin users can use badges to highlight custom metadata right in the asset overview, ensuring greater visibility. Custom metadata badges can help users quickly get the context they need for their data assets, for example:

- If an Airflow DAG was successful
- If a table's data quality checks failed

Atlan currently supports creating badges for custom metadata properties with the following input types - text, number, options, and boolean. Note that Atlan currently does not support creating badges for multivalued types. If [_Allow multiple values_ is toggled on](https://docs.atlan.com/llms/governance/custom-metadata/manage-custom-metadata-structures/llms.txt), you will not be able to create a badge for that custom metadata property.

## Create custom metadata badges

:::warning

Before creating a new badge, you'll need to have created at least one [custom metadata structure](https://docs.atlan.com/llms/governance/custom-metadata/manage-custom-metadata-structures/llms.txt).

:::

To create a custom metadata badge:

1. In your Atlan workspace, click **Settings** from the left menu.

 If you are using the **Old UI (Classic)**, from the left menu of any screen, click **Governance**.

2. Click **Badges**.
3. Under the _Badges_ heading, click **\+ Create new**.
4. In the _Create new badge_ popover, add the following details:
 - For _Custom Metadata property_, select the property you want to create a badge for - in this example, we'll select `Last Run Status` for _Airflow ETL Details_ as the property. 
 - For _Name_, add a name to your badge, such as `Airflow Run Status`.
 - (Optional) For _Description_, add a description.
5. Click **Create** to create your badge.
6. To add options to your custom metadata badge, click **+New option**.
7. To define the options for your custom metadata badge, add the following details:
 - To set a matching condition for your values, select **Equals (=)** or **Not Equals (!=)**.
 - For _Enter value_, enter a value - such as, `Successful`.
 - Click the **grey box** to choose a color for your badge.
 - (Optional) Click the **eye icon** to preview the badge. 
 - (Optional) Click **+New option** to add more options to your badge. 
8. Click **Save** to save your badge options.

Your custom metadata badge is now live! 🎉

## Add custom metadata badges to assets

Once you've created your custom metadata badges, you can add them to your assets. 

:::info **Did you know?** 
 If you [edit the custom metadata properties](https://docs.atlan.com/llms/catalog/discovery/add-custom-metadata/llms.txt) of an asset, the badges will appear automatically.

:::

To add a custom metadata badge to an asset:

1. From the left menu of any screen, click **Assets**. 
2. On the _Assets_ page, select an asset to add a badge.
3. In the asset sidebar on the right, click the custom metadata tab - in this example, we'll select _Airflow ETL Details_.
4. In the custom metadata panel in the sidebar, click **Start editing**.
5. Enter the value(s) you want for the custom metadata properties on the asset and click **Update**.

The custom metadata badge will now be displayed in the asset profile and sidebar! 🎉

---