> ## Documentation Index
> Fetch the complete documentation index at: https://confidence.spotify.com/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.

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

## Create a Label

<Steps>
  <Step title="Navigate to the Labels page">
    Go to **Admin** > **Labels** in the sidebar navigation.
  </Step>

  <Step title="Click Create">
    Click the **Create** button in the top right corner.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Save the label">
    Click **Create** to save the label definition.
  </Step>
</Steps>

## Attach a Label to a Resource

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

<Steps>
  <Step title="Open the resource">
    Navigate to the flag, metric, or experiment you want to label.
  </Step>

  <Step title="Find the Labels section">
    In the sidebar, locate the **Labels** section.
  </Step>

  <Step title="Add a label">
    Click **Add label** and select a label from the dropdown. Then choose a value from the allowed values list.
  </Step>
</Steps>

## Edit a Label Value

To change an existing label value on a resource:

<Steps>
  <Step title="Click the label chip">
    In the resource sidebar, click on the label chip you want to edit.
  </Step>

  <Step title="Select a new value">
    Choose a different value from the dropdown menu.
  </Step>
</Steps>

## Remove a Label from a Resource

<Steps>
  <Step title="Click the label chip">
    In the resource sidebar, click on the label chip you want to remove.
  </Step>

  <Step title="Click the delete icon">
    Click the delete icon to remove the label from the resource.
  </Step>
</Steps>

## Filter by Labels

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

<Steps>
  <Step title="Open a list view">
    Navigate to the Flags, Metrics, or Experiments list page.
  </Step>

  <Step title="Open the filter menu">
    Click the filter button to open the filter dropdown.
  </Step>

  <Step title="Select a label filter">
    Expand the **Labels** submenu and select the label you want to filter by.
  </Step>

  <Step title="Choose values">
    Select one or more values to filter the list.
  </Step>
</Steps>

## Edit a Label Definition

<Steps>
  <Step title="Navigate to the Labels page">
    Go to **Admin** > **Labels**.
  </Step>

  <Step title="Click the label">
    Click on the label you want to edit.
  </Step>

  <Step title="Update the label">
    Modify the display name, description, resource types, or allowed values as needed.
  </Step>

  <Step title="Save changes">
    Click **Save** to apply your changes.
  </Step>
</Steps>

<Note>
  Removing an allowed value does not automatically remove that value from resources that already have it assigned.
</Note>

## Delete a Label

<Steps>
  <Step title="Navigate to the Labels page">
    Go to **Admin** > **Labels**.
  </Step>

  <Step title="Click the label">
    Click on the label you want to delete.
  </Step>

  <Step title="Delete the label">
    Click the **Delete** button and confirm the deletion.
  </Step>
</Steps>

<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.
</Note>

## Related Resources

<CardGroup cols={2}>
  <Card title="Labels Reference" href="/docs/labels/introduction">
    Learn about labels and their components
  </Card>

  <Card title="Flags Reference" href="/docs/flags/introduction">
    Organize feature flags with labels
  </Card>

  <Card title="Metrics Reference" href="/docs/metrics/introduction">
    Categorize metrics with labels
  </Card>

  <Card title="Experiments Reference" href="/docs/experiments/introduction">
    Group experiments with labels
  </Card>
</CardGroup>