Labels
Use labels to categorize issues.
Use labels to categorize issues.
Overview
Labels
Labels organize issues. Create them at the workspace level or for a specific team, so they are available only where they are relevant. Labels used by every team belong at the workspace level.
Each label has a name, a color, and an optional description.
Label groups
Label groups nest related labels. When you label an issue, you apply a label from the group, not the group itself.
Please note that an issue may carry only one label from a given group.
Create labels
Create workspace labels in Settings → Labels (the Issue labels page at /settings/labels/issues). Workspace managers author that catalog.
Create team labels in Settings → Your teams → <team> → Team labels. Team managers can edit team labels.
Use New label or New group to add to the catalog. You can add a description and put the label in a group.
Create a label during add label workflow
You can also create a team label in the add-label flow. Take the action to apply a label, type the name, and pick a color. That creates a team label for the issue's team, not a workspace label.
Apply labels
Apply labels to any issue with the shortcut L, or by clicking the label property on the issue. You can also set them during create, or with bulk Change labels….
An issue can have at most 10 labels. An issue template can pre-set labels.
Manage labels
Labels can be edited, merged, and deleted in label settings. Edit name, color, description, or group from a label row.
On the workspace Issue labels page, optionally turn on Show team labels to see team catalogs next to workspace labels. Use Show archived when you are cleaning up.
If you find duplicates, select several labels and Merge labels. Merge re-points issues onto the target and deletes the sources.
Label descriptions
Add a brief description in label settings. Use it to keep a consistent sense of when the label should be applied.
Archive labels
Archive… keeps the label on issues that already have it and hides it from pickers. Unarchive brings it back.
Delete labels
If you are sure a label no longer needs to exist, Delete label. Deletion removes it from issues where it is applied, so please proceed with caution. Consider archiving instead when you want to keep historical context.
Filtering and views
Press F and add a Labels filter. Learn more about filters.
Display options (Shift V) can show a Labels column under Display properties.
Last updated on