Labels
Labels provide a flexible tagging system that can be applied to any entity in the platform. They complement structured categorisation fields by allowing users to organise and filter records using custom, colour-coded tags.
Label definitions
Each label has a name, colour, and optional scope:
| Attribute | Purpose |
|---|---|
| Name | Unique name within the tenant |
| Colour | Hex colour for UI display |
| Scope | Optional scope prefix (e.g. priority, status) |
| Value | Value within the scope |
Scoped labels
Labels can optionally use a scope::value pattern to create mutually exclusive groups. Within a scope, an entity can have only one label value at a time.
For example, if a priority scope has labels priority::high, priority::medium, and priority::low, applying priority::high to a record will automatically remove any other priority:: label from that record.
Unscoped labels have no such restriction — an entity can have as many unscoped labels as needed.
Applying labels
Labels use a generic linking mechanism that allows them to be applied to any entity type in the system. This means the same set of labels can be used across documents, work items, customers, and any other record type without requiring separate configuration for each.