## Manage custom metadata badges

URL: https://docs.atlan.com/product/capabilities/build-apps/sdks/python/custom-metadata/how-tos/manage-badges

> Create and delete custom metadata badges in Atlan using the Python SDK — surface business attribute values as visual badges on asset cards to improve data trust at a glance.

# Badge: create and manage custom metadata badges

Use `Badge` in the Atlan Python SDK to programmatically create and manage badges that surface custom metadata values on asset cards.

You can use *badges* in Atlan to provide quick indicators of key signals from custom metadata. They appear in the Overview of the asset, rather than nested within the custom metadata tab.

:::tip[Badges are a kind of asset]
Badges are actually modeled as just another kind of asset in Atlan. This means all the standard [CRUD operations](https://docs.atlan.com/llms/platform/python/asset-crud/llms.txt) apply to badges the same as any other asset.
:::

## Create badge

For example, to create a badge for custom metadata capturing a count of data quality checks that have run:

### Java

```java showLineNumbers title="Build a badge"
Badge badge = Badge.creator(client, // (1)
 "DQ Count", // (2)
 "Data Quality", // (3)
 "Count") // (4)
 .userDescription("How many data quality checks ran against this asset.") // (5)
 .badgeCondition( // (6)
 BadgeCondition.of(
 BadgeComparisonOperator.GTE, // (7)
 5, // (8)
 BadgeConditionColor.GREEN)) // (9)
 .badgeCondition(
 BadgeCondition.of(
 BadgeComparisonOperator.LT,
 5,
 BadgeConditionColor.YELLOW))
 .badgeCondition(
 BadgeCondition.of(
 BadgeComparisonOperator.LTE,
 2,
 BadgeConditionColor.RED))
 .build(); // (10)
AssetMutationResponse response = badge.save(client); // (11)
```

1. Like with any other asset, use the `creator()` method to make sure you provide the minimal information required to create a badge. Because this operation may need to retrieve information from Atlan, you must [provide it an `AtlanClient`](https://docs.atlan.com/llms/platform/python/set-up-sdk/llms.txt) through which to connect to the tenant.
2. You must provide a name for the badge.
3. You must specify the name of the custom metadata set the badge will summarize.
4. You must provide the name of the custom metadata property within that set the badge will represent.
5. You can optionally provide other details about the badge, like with any other asset. In this example we provide a description for the badge.
6. You can then specify any number of conditions to represent in the badge.
7. Each condition is comprised of an operator (standard mathematical comparisons),
8. ...a value against which to compare the asset's value for the property,
9. ...and the color to apply to the badge if the asset's value for the property matches the value (as compared through the operator). This can be one of the predefined colors, or any RGB-based hex value for a custom color.
10. As with all other builder patterns, you must `build()` the object you've defined.
11. The `save()` operation will actually create the badge within Atlan, including its conditions. Because this operation will persist the structure in Atlan, you must [provide it an `AtlanClient`](https://docs.atlan.com/llms/platform/python/set-up-sdk/llms.txt) through which to connect to the tenant.

### Python

```python showLineNumbers title="Build a badge"
from pyatlan.client.atlan import AtlanClient
from pyatlan.model.assets import Badge
from pyatlan.model.enums import BadgeConditionColor, BadgeComparisonOperator
from pyatlan.model.structs import BadgeCondition

client = AtlanClient()
badge = Badge.creator( # (1)
 client=client, # (2)
 name="DQ Count", # (3)
 cm_name="Data Quality", # (4)
 cm_attribute="count", # (5)
 badge_conditions=[ # (6)
 BadgeCondition.create( # (7)
 badge_condition_operator=BadgeComparisonOperator.GTE, # (8)
 badge_condition_value="5", # (9)
 badge_condition_colorhex=BadgeConditionColor.GREEN, # (10)
 ),
 BadgeCondition.create(
 badge_condition_operator=BadgeComparisonOperator.LT,
 badge_condition_value="5",
 badge_condition_colorhex=BadgeConditionColor.YELLOW,
 ),
 BadgeCondition.create(
 badge_condition_operator=BadgeComparisonOperator.LTE,
 badge_condition_value="2",
 badge_condition_colorhex=BadgeConditionColor.RED,
 ),
 ],
)
badge.user_description = "How many data quality checks ran against this asset." # (11)
response = client.asset.save(badge) # (12)
assert (assets := response.assets_created(asset_type=Badge) # (13)
```

1. Like with any other asset, use the `create()` method to make sure you provide the minimal information required to create a badge.
2. You must provide a client instance.
3. You must provide a name for the badge.
4. You must specify the name of the custom metadata set the badge will summarize.
5. You must provide the name of the custom metadata property within that set the badge will represent.

 :::warning[Property is renamed]
The property names used have been converted to the standard python form, that is, lowercase with spaces replaced with an underscore.
 :::
6. You can then specify any number of conditions to represent in the badge.
7. Use the 'create()' method to provide the information needed to create the `BadgeCondition`.
8. Each condition is comprised of an operator (standard mathematical comparisons),
9. ...a value against which to compare the asset's value for the property,
10. ...and the color to apply to the badge if the asset's value for the property matches the value (as compared through the operator). This can be one of the predefined colors, or any RGB-based hex value for a custom color.
11. You can optionally provide other details about the badge, like with any other asset. In this example we provide a description for the badge.
12. The `save()` operation will actually create the badge within Atlan, including its conditions.
13. Check that the `Badge` was created.

### Kotlin

```kotlin showLineNumbers title="Build a badge"
val badge = Badge.creator(client, // (1)
 "DQ Count", // (2)
 "Data Quality", // (3)
 "Count") // (4)
 .userDescription("How many data quality checks ran against this asset.") // (5)
 .badgeCondition( // (6)
 BadgeCondition.of(
 BadgeComparisonOperator.GTE, // (7)
 5, // (8)
 BadgeConditionColor.GREEN)) // (9)
 .badgeCondition(
 BadgeCondition.of(
 BadgeComparisonOperator.LT,
 5,
 BadgeConditionColor.YELLOW))
 .badgeCondition(
 BadgeCondition.of(
 BadgeComparisonOperator.LTE,
 2,
 BadgeConditionColor.RED))
 .build() // (10)
val response = badge.save(client) // (11)
```

1. Like with any other asset, use the `creator()` method to make sure you provide the minimal information required to create a badge. Because this operation may need to retrieve information from Atlan, you must [provide it an `AtlanClient`](https://docs.atlan.com/llms/platform/python/set-up-sdk/llms.txt) through which to connect to the tenant.
2. You must provide a name for the badge.
3. You must specify the name of the custom metadata set the badge will summarize.
4. You must provide the name of the custom metadata property within that set the badge will represent.
5. You can optionally provide other details about the badge, like with any other asset. In this example we provide a description for the badge.
6. You can then specify any number of conditions to represent in the badge.
7. Each condition is comprised of an operator (standard mathematical comparisons),
8. ...a value against which to compare the asset's value for the property,
9. ...and the color to apply to the badge if the asset's value for the property matches the value (as compared through the operator). This can be one of the predefined colors, or any RGB-based hex value for a custom color.
10. As with all other builder patterns, you must `build()` the object you've defined.
11. The `save()` operation will actually create the badge within Atlan, including its conditions. Because this operation will persist the structure in Atlan, you must [provide it an `AtlanClient`](https://docs.atlan.com/llms/platform/python/set-up-sdk/llms.txt) through which to connect to the tenant.

### Raw REST API

```json showLineNumbers title="POST /api/entity/bulk"
{
 "entities": [ // (1),
 {
 "badgeConditionOperator": "lt",
 "badgeConditionValue": "5",
 "badgeConditionColorhex": "#F7B43D"
 },
 {
 "badgeConditionOperator": "lte",
 "badgeConditionValue": "2",
 "badgeConditionColorhex": "#BF1B1B"
 }
 ]
 }
 }
 ]
}
```

1. Like with any other asset, define the badge within an `entities` array.
2. You must use the exact value `Badge` as the `typeName` for a badge.
3. You must provide a name for the badge.
4. You must specify the full name of the custom metadata property (its set and property name). These must also use [Atlan's internal hashed-string representation](https://docs.atlan.com/llms/platform/python/add-custom-metadata/llms.txt).
5. You must provide a `qualifiedName` for the badge that uses the format: `badges/global/<custom-metadata-property>`, where `<custom-metadata-property> is the full name of the custom metadata property (using [Atlan's internal hashed-string representation](https://docs.atlan.com/llms/platform/python/add-custom-metadata/llms.txt)).
6. You can optionally provide other details about the badge, like with any other asset. In this example we provide a description for the badge.
7. You can then specify any number of conditions to represent in the badge.
8. Each condition is comprised of an operator (standard mathematical comparisons),
9. ...a value against which to compare the asset's value for the property,

 :::warning[Must be a string in the JSON]
The value you provide must always be a string in JSON. For actual string values (for text fields and options fields), you must further wrap the string itself in double-quotes.
 :::
10. ...and the color to apply to the badge if the asset's value for the property matches the value (as compared through the operator). This should be an RGB-based hex value. (The colors given in this example are the standard green, amber, red used in the UI.)

Now that the badge has been created, any assets with a [value set for the custom metadata](https://docs.atlan.com/llms/platform/python/add-custom-metadata/llms.txt) will show the badge on its overview tab.

## Delete badge

You can delete a badge at any time using:

### Java

```java showLineNumbers title="Delete a badge"
AssetDeletionResponse response = Badge.purge(client, "1c932bbb-fbe6-4bbc-9d0d-3df2f1fa4f81"); // (1)
```

1. The `purge()` operation will permanently delete the badge, given the GUID of the badge. Because this operation will remove the structure from Atlan, you must [provide it an `AtlanClient`](https://docs.atlan.com/llms/platform/python/set-up-sdk/llms.txt) through which to connect to the tenant.

### Python

```python showLineNumbers title="Delete a badge"
response = client.asset.purge_by_guid("1c932bbb-fbe6-4bbc-9d0d-3df2f1fa4f81") # (1)
```

1. The `asset.purge_by_guid()` operation will permanently delete the badge, given the GUID of the badge.

### Kotlin

```kotlin showLineNumbers title="Delete a badge"
val response = Badge.purge(client, "1c932bbb-fbe6-4bbc-9d0d-3df2f1fa4f81") // (1)
```

1. The `purge()` operation will permanently delete the badge, given the GUID of the badge. Because this operation will remove the structure from Atlan, you must [provide it an `AtlanClient`](https://docs.atlan.com/llms/platform/python/set-up-sdk/llms.txt) through which to connect to the tenant.

### Raw REST API

```json showLineNumbers title="DELETE /api/meta/entity/bulk?guid=1c932bbb-fbe6-4bbc-9d0d-3df2f1fa4f81&deleteType=PURGE"
// (1)
```

1. All information needed to permanently delete the badge is provided in the URL (in particular the GUID of the badge).

Now that the badge has been deleted, no assets will show it on their overview tab.

---