# 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]].