Labels
The Labels page (route /labels) manages the labels you can attach to resources, users, groups, and resource groups. Labels are tags you use to organise objects and to drive policies, permissions, and navigation.
Purpose
A label is a named tag you can attach to resources and other objects. Because labels travel with the objects, you can filter lists by label, build policies that match labels, and control which labels appear in the user’s navigation. The Labels page is where labels are created, renamed, deleted, and associated with the objects they apply to.
Labels work with policies and permissions: a policy or permission rule can target everything that carries a given label, which is more robust than listing objects individually.
Why use it
- Organise resources, users, groups, and resource groups into logical sets (for example by environment, department, or sensitivity).
- Drive policies and permissions by label instead of listing individual objects.
- Control the user navigation: labels marked as navigation-enabled can structure what users see.
- Attach the same label to many objects in one operation (see Update labels for all selected resources).
When to use it
- When you start adding enough resources that a naming convention alone is not enough to group them.
- When you want a policy rule that applies to a set of resources that share a characteristic.
- When you want to expose a subset of objects in the end-user navigation.
Prerequisite: permission to manage labels. The page shows a no permissions message otherwise.
How to use it
- Open Organisation > Labels from the left navigation.
- The table lists existing labels with the counts of attached resources, users, groups, and resource groups, and whether Navigation Enabled is on.
- To create a label, select ADD LABEL, type a name in the new row, and confirm. The label appears in the table once saved.
- Use a row’s actions menu to attach objects:
| Action | What it does |
|---|---|
| Configure Resources | Attach or detach resources |
| Configure Users | Attach or detach users |
| Configure Groups | Attach or detach groups |
| Configure Resource Groups | Attach or detach resource groups |
- Toggle Navigation Enabled if the label should appear in the user navigation.
- To delete labels, select their rows and choose DELETE LABELS.
Fields and controls reference
| Column | Meaning |
|---|---|
| Name | The label’s name |
| Resources | Number of resources carrying the label |
| Users | Number of users carrying the label |
| Groups | Number of groups carrying the label |
| Resource Groups | Number of resource groups carrying the label |
| Navigation Enabled | Whether the label appears in the end-user navigation |
| Actions | Row menu: Configure Resources, Configure Users, Configure Groups, Configure Resource Groups |
Creating a label
| Field | Purpose | Required | Valid values | Notes |
|---|---|---|---|---|
| Name | The label’s name | Yes | A label name | Must be unique among labels |
Dialogs and popups
Update labels for all selected resources
When you select multiple resources on a resource overview page, the labels action opens a dialog titled Update labels for all selected resources. It shows a chip list of labels; add or remove labels and select REPLACE ALL to apply the label set to every selected resource, or CANCEL to back out. This dialog is reachable from the resource overview screens (for example Applications) rather than from the Labels page itself.
Configure dialogs
The Configure Resources, Configure Users, Configure Groups, and Configure Resource Groups actions open picker lists in the row (or as dialogs) where you add and remove the objects carrying the label.
Configuration versus diagnostics versus confirmation
- Configuration: creating labels, attaching objects, and toggling navigation.
- Diagnostics: the counts in the table are read-only summaries of current associations.
- Confirmation: deleting labels applies after you select rows and choose DELETE LABELS; there is no second confirmation step.
Pagination and async behaviour
- The table pages at 25 rows per page.
- Label changes are asynchronous: after adding a label, attaching objects, or deleting, wait a few seconds and reload to confirm. Notifications confirm each change.
Troubleshooting
- A label does not appear after adding it: confirm the row was saved (a notification confirms creation) and reload the table.
- A policy that matches a label is not applying: check that the objects actually carry the label (the counts in the table should reflect them) and that the policy references the label correctly (see Policies).
- Users do not see the label in navigation: enable Navigation Enabled for the label.
- I cannot delete a label: select the rows first; DELETE LABELS acts on the selected rows.