> ## 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.

# Introduction to labels

> Reference documentation for labels in Confidence.

Labels are user-defined tags that help you categorize and organize resources in Confidence.
Use labels to group related flags, metrics, and experiments for easier filtering and discovery.

## Label components

A label definition consists of:

* **Name**: A human-readable name for the label
* **Key**: A unique identifier auto-generated from the display name (lowercase letters, numbers, and hyphens)
* **Description**: Optional text explaining the label's purpose
* **Resource types**: Which resources this label applies to (flags, metrics, or experiments)
* **Allowed values**: A predefined list of valid values for the label

## Supported resources

Labels can be attached to:

* **Flags**: Categorize feature flags by team, project, or any custom dimension
* **Metrics**: Organize metrics by domain, ownership, or data source
* **Experiments**: Group A/B tests, rollouts, and analyses by initiative or product area

## Using labels

After you create a label definition, the label appears in the sidebar of supported resources.
You can assign values to resources and filter list views by label values.

Labels appear as chips in list views, making it easy to see at a glance how resources are categorized.
When space is limited, labels collapse into a "+ X labels" indicator that expands on click.

When adding metrics to an experiment, you can filter the metrics picker by label values to quickly
find relevant metrics. This is useful when you have many metrics and want to narrow down
the selection to a specific team, product area, or category.

## Related resources

<CardGroup cols={2}>
  <Card title="Manage Labels" href="/docs/how-to-guides/manage-labels">
    Create and configure labels
  </Card>

  <Card title="Flags Reference" href="/docs/flags/introduction">
    Learn about feature flags
  </Card>

  <Card title="Metrics Reference" href="/docs/metrics/introduction">
    Learn about metrics
  </Card>

  <Card title="Experiments Reference" href="/docs/experiments/introduction">
    Learn about experiments
  </Card>
</CardGroup>