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