Taxonomy management is available to users with the Librarian or CloudAdmin role. The full taxonomy is built and maintained in the Tag 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.
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 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.
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.
Merging tags cannot be undone.
Import and export taxonomies
Taxonomies can be imported from CSV via the Tag 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
| Column | Required | Description |
|---|
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.