> 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/terms.md).

# Terms

**Where:** Database → Taxonomies → taxonomy → Terms · `/projects/<project>/db/taxonomies/<taxonomyName>/terms (+ /new, /<termId>/edit)`

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

Terms are the actual values records get tagged with — for example `electronics`, `books`, `clothing` inside a `categories` taxonomy. The list ( *"categories" Taxonomy Terms* ) shows each term with its **Parent** and **Order**; **Add New Term** opens the form.

## Fields

* **Title** (required in at least one language) and **Description** — both translatable. When the project has several languages, language tabs switch which translation you edit.
* **Order** — a number; lower numbers show first, empty means unordered (those sort after the ordered terms).
* **Parent** — only shown when the taxonomy has a Parent taxonomy, and then **required**: the picker lists that taxonomy's terms (e.g. a `Cities` term must select its `Countries` term). The validation message is *Please select a parent from Countries.*
* **Additional categories** — only shown when the taxonomy has Additional categories configured: checkbox lists of terms from those taxonomies. A term set as Parent cannot also be ticked here.

**Save** writes the term and returns to the list; **Delete** (edit only) asks for confirmation. When other taxonomies use this one as their Parent, editing a term also lists its child terms below the form — e.g. editing a `Regions` term shows its `Countries`, each linking to that term's edit screen, with an **Add New** that pre-selects this term as the parent.

## Use it from code

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

## API reference

Endpoints: [Save Database Taxonomy Term](/api-reference/database/taxonomies/save-database-taxonomy-term.md), [Update Database Taxonomy Term](/api-reference/database/taxonomies/update-database-taxonomy-term.md), [Find Terms](/api-reference/database/taxonomies/find-terms.md).