devguard
Collections

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

  1. Open Collections, then Labels, and choose Add label.
  2. Enter the Name, for example Personal data.
  3. If the label belongs to a group, enter the Scope, for example privacy. Use the same spelling for every label in the group.
  4. Choose Pick a color. Give labels of one scope related colors.
  5. Choose Create.
The label list: names such as Business critical, Confidential and ISO 27001, each with a scope such as priority, classification or framework, and a color.
Each label has a scope and a color. Labels with the same scope belong together.

Put a label on a risk, asset or other entry

  1. Open the risk, asset, vendor, evidence item, incident or process and choose Edit.
  2. In Labels, choose one or more labels.
  3. Save.

To find the tagged entries, filter the register's list by Labels.


Reference

FieldRequiredNotes
Nameyes2 to 255 characters.
ScopenoA group name. The policy PDF prints a label mention as scope:name.
Coloryes in the appPick 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.
SlugyesMade from the name. See Collections.
  • The label list can be filtered by Scope and Last updated.
  • In a register's CSV import, a labels column 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.

labels.csv
slug,name,scope,color
personal-data,Personal data,privacy,#7c3aed

API

The calls are the same for all collections; see the Collections API. The path is /labels/.

FieldTypeRequired
organizationIdstringon create
namestring, 2 to 255 charactersyes
slugstring, lowercase with hyphensyes
scopestringno
colorstring, up to 200 characters: a hex code such as #7c3aed, an rgb() or hsl() color, a CSS color name or a linear-gradient()no
POST /labels/
{
  "organizationId": "<organization id>",
  "name": "Personal data",
  "slug": "personal-data",
  "scope": "privacy",
  "color": "#7c3aed"
}

How is this guide?

On this page