> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Taxonomies

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.

<Warning>
  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.
</Warning>

## 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.

<Warning>
  Merging tags cannot be undone.
</Warning>

## 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](/cloud/reference/api/taxonomy-api) and returns the full taxonomy as a CSV file, suitable for backup or seeding another environment. Download a [sample import file](/attachments/cloud/sample-taxonomy.csv) 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](/cloud/platform-capabilities/features/knowledge-management/browse-assets): Browse the full taxonomy and find tagged entities.

* [Apply Tags](/cloud/platform-capabilities/features/knowledge-management/apply-tags): How to assign tags to entities in Domino.