Labels

Use labels to categorize issues.

Overview⁠

Labels⁠

Labels allow you to organize issues. Create them scoped to the workspace or a specific team level, so they're available only where relevant. You should create labels that are used by all teams (e.g. "Bug") in the workspace-level, so they will be accessible to all teams.

Label groups⁠

Label groups create one level of nesting in your workspace and team labels, giving you more options when organizing issues. Each label group is limited to 250 labels.

Please note that labels within groups are not multi-selectable, so when applying labels to issues only one label from each group may be applied.

Create labels⁠

Create and/or manage labels in either the Settings > Workspace > Labels page or Team settings > Labels.

Create a label during add label workflow⁠

You can also create labels in the Add label flow. Take the action to apply a label, then type the name of the label you want to create. The label will be automatically be saved to your team's labels.

If you'd like to create a label or label group directly from the Add label flow, this is available with the syntax label group/label or label group:label . For example, using Type/Bug or Type:Bug will create the label group "Type" and the label "Bug".

Apply labels⁠

Apply labels to any issue with the shortcut L, or by clicking into the label property field in an issue's right sidebar.

Manage labels⁠

Once created, labels can be edited or deleted in issue label settings. In workspace label settings, optionally select to display all labels on that page for ease of editing. Or, in larger workspaces, search for particular labels to assist in cleanup.

Edit label name or color by clicking on those properties in a label row. Or, right click on the row to see additional options like converting to a group, moving to workspace, or deleting the label.

Take bulk actions by selecting multiple labels (x or Shift + click.) Right click any of these labels action each selected label. You move the labels from workspace to team, merge multiple labels into a single label, convert to label groups

Deleting labels⁠

Use the data columns in label settings like description, rules, issues, last applied and created to get a sense of whether a label is still in active use before deleting it. Deleting labels is not reversible (including by us) and will remove it from issues where it's applied, so please proceed with caution.

Filtering and views⁠

Team-specific labels "act" like workspace labels when filtering All teams or multi-team views. As long as labels in different teams share the same name, filtered results will show all issues across all teams that match the label. This holds true in custom Views, My Issues, Project All team views, and general search (/). It does not extend to the API (you'll have to use the unique identifier for each team's label).

If you only want to see results for a specific team's labels in a multi-team view, add a team filter on top of the label filter. Creating a workspace label with the same name as existing team label(s), will present the option to convert the team label(s) to the workspace level.

Learn more about Label views and how to filter for labels.

Reserved label names⁠

We reserve the following label names that are duplicative of existing features to not cause confusion:

"assignee", "cycle", "effort", "estimate", "hours", "priority", "project", "state", "status",