> ## Documentation Index
> Fetch the complete documentation index at: https://confidence-auth-testing.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage labels

> Learn how to create and manage labels to organize resources in Confidence.

**Manage labels**

Learn how to create and manage labels to organize resources in Confidence.

[Labels](/docs/platform/labels) help you categorize flags, metrics, and experiments
with custom tags. This guide covers creating label definitions and attaching labels to resources.

## Create a Label

**1. Navigate to the Labels page**

Go to **Admin** > **Labels** in the sidebar navigation.

**2. Click Create**

Click the **Create** button in the top right corner.

**3. Enter label details**

Fill in the label form:

* **Display name**: A descriptive name for the label (for example, "Team" or "Product Area")
* **Description**: Optional explanation of what this label represents
* **Resource types**: Select which resources can use this label (Flags, Metrics, or Experiments)
* **Allowed values**: Add the valid values for this label (for example, "Frontend", "Backend", "Mobile")

The label key is auto-generated from the display name.

**4. Save the label**

Click **Create** to save the label definition.

## Attach a Label to a Resource

After creating a label, you can attach it to flags, metrics, or experiments.

**1. Open the resource**

Navigate to the flag, metric, or experiment you want to label.

**2. Find the Labels section**

In the sidebar, locate the **Labels** section.

**3. Add a label**

Click **Add label** and select a label from the dropdown. Then choose a value from the allowed values list.

## Edit a Label Value

To change an existing label value on a resource:

**1. Click the label chip**

In the resource sidebar, click on the label chip you want to edit.

**2. Select a new value**

Choose a different value from the dropdown menu.

## Remove a Label from a Resource

**1. Click the label chip**

In the resource sidebar, click on the label chip you want to remove.

**2. Click the delete icon**

Click the delete icon to remove the label from the resource.

## Filter by Labels

Labels appear as filter options in list views for flags, metrics, and experiments.

**1. Open a list view**

Navigate to the Flags, Metrics, or Experiments list page.

**2. Open the filter menu**

Click the filter button to open the filter dropdown.

**3. Select a label filter**

Expand the **Labels** submenu and select the label you want to filter by.

**4. Choose values**

Select one or more values to filter the list.

## Edit a Label Definition

**1. Navigate to the Labels page**

Go to **Admin** > **Labels**.

**2. Click the label**

Click on the label you want to edit.

**3. Update the label**

Modify the display name, description, resource types, or allowed values as needed.

**4. Save changes**

Click **Save** to apply your changes.

> [!NOTE]
>
> Removing an allowed value does not automatically remove that value from resources that already have it assigned.

## Delete a Label

**1. Navigate to the Labels page**

Go to **Admin** > **Labels**.

**2. Click the label**

Click on the label you want to delete.

**3. Delete the label**

Click the **Delete** button and confirm the deletion.

> [!NOTE]
>
> Deleting a label definition does not remove the label values from resources that already have them assigned.
> The label values remain on those resources but are no longer visible or editable in the UI.

## Related Resources

> **[Labels Reference](/docs/platform/labels)**
>
> Learn about labels and their components