Skip to main content
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.

Manage Labels

Create and configure labels

Flags Reference

Learn about feature flags

Metrics Reference

Learn about metrics

Experiments Reference

Learn about experiments