# Labels
Labels are coloured tags you apply to team tasks to mark cross-cutting concerns: bug, blocked, needs review, customer-facing, or anything else that doesn't fit neatly into status or priority. A task can have multiple labels, and the board can filter and group by them.
See also: [[Managing Team Tasks]] for how labels appear on tasks, and [[Custom Fields]] for structured per-task data.
> [!quote] Tags for what status doesn't cover
> Status tells you where a task is in the workflow. Labels tell you what else is true about it: flagged, needs design, a specific customer request, anything your team wants to track without adding another status column.
## Where labels live
Labels are defined **per project** under **Settings → Labels** (the tag icon in the settings nav). They are separate from your personal [[Projects & Labels|labels]]. Team labels only exist within a Team Project and are visible to all members.
---
## Setting up labels
![[team-settings-labels.png]]
From **Settings → Labels**:
- **Add a label**: give it a name and pick a colour from the swatch grid
- **Rename a label**: updates the label everywhere it appears: every task carrying it, saved view filters, and [[Intake Forms|Service Desk intake forms]] that reference it, with colours and filters intact
- **Recolour a label**: click the colour dot next to any label to open the colour picker
- **Delete a label**: removes it from project settings and from all tasks
- **Reorder labels**: drag labels into the order you want from Settings
> [!note] Old label names stay reserved
> After a rename, the label's previous name is reserved and can't be given to a label again. That keeps anything still referencing the old name pointing at the right label, so pick the new name with that in mind.
---
## Applying labels to tasks
### From List view
Each task row shows label pills inline. Click the label area on a row to open the **label picker**:
- Search for an existing label by name
- Click a label to toggle it on or off
- Create a new label directly from the picker, without going to Settings first
Up to **2 label pills** are visible on a task row. If a task has more, a **+N badge** appears. Click the badge to open the picker and see all labels on that task.
### From the task panel
Open any task and find the **Labels** section in the Properties panel. The same picker is available there: search, toggle or create labels inline.
### On subtasks
Label pills appear on subtask rows in List view in compact, read-only form. Edit labels from the subtask row picker or by opening the subtask.
> [!tip] Create labels without leaving the board
> The label picker lets you create new labels on the fly. Type a name that doesn't exist yet and choose a colour. The label is added to project settings and applied to the task in one step.
---
## Clicking a label pill
Clicking an existing label pill on a task row opens a compact popup with three actions:
- **Change color**: pick a new colour from the swatch grid
- **Remove from task**: removes just this label from this task
- **Filter by label**: sets the list view to show only tasks with this label
---
## Filtering by label
Labels appear as a dimension in the **filter panel**. Select one or more labels to narrow the list to tasks that have any of those labels applied (multiselect OR semantics).
> [!tip] Combine with other filters
> Label filters stack with status, assignee, and priority filters. This is useful for queries like "urgent tasks labelled 'blocked'" or "in-review tasks for a specific sprint that are customer-facing".
---
## Grouping by label
Choose **Group by Label** in List view to organise tasks by their labels.
- A task with **multiple labels** appears in each label's group. This is intentional
- Tasks with **no labels** collect in an **Unlabeled** group at the bottom
> [!note] Multi-membership grouping
> Unlike grouping by status or priority (where each task is in exactly one group), grouping by label shows a task in every group it belongs to. This is expected behaviour, not a duplicate.
---
## Labels vs. custom fields
Labels and [[Custom Fields]] are different tools for different purposes:
| | Labels | Custom Fields |
|--|--------|--------------|
| **Values per task** | Multiple | One per field |
| **Purpose** | Tags and cross-cutting concerns | Structured data (sprint, story points, links) |
| **Filtering** | Multiselect filter | Per-field filter (select fields only) |
| **Grouping** | Yes (multi-membership) | Yes (select fields only) |
| **Created from** | Settings or inline from the picker | Settings only |
| **Coloured** | Yes, per label | Yes, per select option |
Use labels when a task can be "more than one thing at once." Use a select custom field when a task is exactly one of a fixed set of values (like sprint).
---
**Next:** See all task properties in [[Managing Team Tasks]], or configure your project in [[Setting Up a Team Project]].