Manage Taxonomies

Taxonomy management is available to users with the Librarian or CloudAdmin role. The full taxonomy is built and maintained in the Knowledge Browser under Govern.

Namespaces

A namespace is a top-level grouping of related tags — for example, business-domain, data-sensitivity, or project-status.

Namespace labels are alphanumeric and support hyphens and underscores.

Important
Each namespace has an independent assignment policy: when Allow multiple tags per entity is off (the default), an entity can hold only one tag from that namespace at a time.

Tags

Tags live within a namespace and support hierarchical organization through parent-child relationships. A tag can be created as a root-level entry or nested under an existing tag.

Tags can be edited or deprecated at any time. A deprecated tag remains on any entities currently assigned to it but cannot be applied to new ones — useful for retiring a classification without breaking existing assignments.

Merge tags

Merging consolidates duplicate or overlapping tags. All assignments from the source tags are transferred to the target tag, and the source tags are permanently deleted.

Caution
Merging tags cannot be undone.

Import and export taxonomies

Taxonomies can be imported from CSV via the Knowledge Browser — useful for migrations or bootstrapping from an existing spreadsheet or external provider. Export is available via the Taxonomy API and returns the full taxonomy as a CSV file, suitable for backup or seeding another environment. Download a sample import file to get started.

Each row in the import file defines one tag. The file has no header row. The columns are:

namespace_label,namespace_description,tag_path,tag_description
ColumnRequiredDescription

namespace_label

Yes

Namespace name. Created automatically if it does not already exist.

namespace_description

No

Namespace description.

tag_path

Yes

Slash-separated hierarchy (for example, Oncology/Phase-1 creates a Phase-1 tag nested under Oncology).

tag_description

No

Tag description.

The import preview flags any rows with errors before anything is committed.

Next steps

  • Browse Assets: Browse the full taxonomy and find tagged entities.

  • Apply Tags: How to assign tags to entities in Domino.