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”)
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.
Related Resources
Labels Reference
Learn about labels and their components
Flags Reference
Organize feature flags with labels
Metrics Reference
Categorize metrics with labels
Experiments Reference
Group experiments with labels