> For the complete documentation index, see [llms.txt](https://docs.codemash.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codemash.io/cloud/database/taxonomies/new.md).

# Create a taxonomy

**Where:** Database → Taxonomies → New · `/projects/<project>/db/taxonomies/new`

{% hint style="info" %}
Screenshot TODO — capture comes from testing-plan area **04-taxonomies**.
{% endhint %}

## Fields

* **Taxonomy name** (required) — e.g. `Cities`.
* **Description** — free text.
* **Parent** — one other taxonomy (default *— None —*). Setting it places this taxonomy in a tree: every term you later create must then pick a required parent term from that taxonomy.
* **Additional categories** — checkboxes with the project's other taxonomies. Terms can then carry extra parents from those taxonomies. A taxonomy set as Parent cannot also be ticked here — the form rejects it with *A taxonomy cannot be both the Parent and an Additional category. Remove it from one.*

**Save** stores the taxonomy (`txn_…`) and returns to the list; **Cancel** discards. After saving you add the actual [terms](/cloud/database/taxonomies/terms.md) records get tagged with.

Example: create `Countries` with no parent, then `Cities` with **Parent** = `Countries`. Every city term must now name its country, and the API can fetch a country's cities as term children.

## Use it from code

[Database → Taxonomies](/sdks-and-cli/database/taxonomies.md)

## API reference

Endpoints: [Save Database Taxonomy](/api-reference/database/taxonomies/save-database-taxonomy.md).