Labels
Tag risks, assets, vendors, evidence, incidents and processes with your own colored labels, so you can group and filter them the same way everywhere.
A label is a colored tag that you put on risks, assets, vendors and more, such as Personal data or Quick win. One set of labels works across risks, assets, vendors, evidence, incidents and processes. Policies and records can mention a label with :. A scope groups related labels, for example classification for Public, Internal and Confidential.
To import, archive or delete labels, see Collections. Scripts and integrations: see API below.
Add a label
- Open Collections, then Labels, and choose Add label.
- Enter the Name, for example
Personal data. - If the label belongs to a group, enter the Scope, for example
privacy. Use the same spelling for every label in the group. - Choose Pick a color. Give labels of one scope related colors.
- Choose Create.

Put a label on a risk, asset or other entry
- Open the risk, asset, vendor, evidence item, incident or process and choose Edit.
- In Labels, choose one or more labels.
- Save.
To find the tagged entries, filter the register's list by Labels.
Reference
| Field | Required | Notes |
|---|---|---|
| Name | yes | 2 to 255 characters. |
| Scope | no | A group name. The policy PDF prints a label mention as scope:name. |
| Color | yes in the app | Pick one, or enter a hex code such as #7c3aed. A CSV import or the API also takes an rgb() or hsl() color, a CSS color name such as teal, or a linear-gradient(). Optional over the API. |
| Slug | yes | Made from the name. See Collections. |
- The label list can be filtered by Scope and Last updated.
- In a register's CSV import, a
labelscolumn can hold label names instead of ids. Separate several names with a comma or a semicolon. - When you delete a label, it is removed from every entry that has it. Archive it instead if the history matters.
CSV columns
The template from Download CSV template has these columns. Leave slug empty to make it from the name.
slug,name,scope,color
personal-data,Personal data,privacy,#7c3aedAPI
The calls are the same for all collections; see the Collections API. The path is /labels/.
| Field | Type | Required |
|---|---|---|
organizationId | string | on create |
name | string, 2 to 255 characters | yes |
slug | string, lowercase with hyphens | yes |
scope | string | no |
color | string, up to 200 characters: a hex code such as #7c3aed, an rgb() or hsl() color, a CSS color name or a linear-gradient() | no |
{
"organizationId": "<organization id>",
"name": "Personal data",
"slug": "personal-data",
"scope": "privacy",
"color": "#7c3aed"
}How is this guide?