Taxonomies

A taxonomy is a reusable, named list of values — its terms — that you define once and then reuse across your catalog. Instead of typing the same set of options into every field that needs them, you keep the list in one place and point fields at it. Edit the taxonomy once and every field using it updates automatically.

Good examples of a taxonomy are Colors, Materials, or Sizes: a fixed set of values you’ll pick from again and again.

How taxonomies fit with the rest of your catalog

Taxonomies sit alongside the other ways you organize a catalog, but they solve a different problem:

Categories classify what a product is (a hierarchical tree). One per product.
Lists group products for a workflow or output. Many per product.
Taxonomies define the set of allowed values for a field — a shared option list, not a grouping of products.

So a taxonomy isn’t assigned to a product directly. It feeds the choice and multi-choice custom fields (“sections”) on your products: when a field reads its options from a taxonomy, everyone selecting a value for that field picks from the same, consistent list.

Terms

Each value in a taxonomy is a term. A term has:

an external ID — a stable code that identifies the term (used to match rows on import, so re-importing doesn’t create duplicates);
a label — the human-readable text shown in the dashboard;
an optional description;
an optional color — one of gray, red, orange, yellow, green, blue, purple, or pink.

The color carries through to your catalog: a value chosen from a taxonomy shows up as a colored badge in the products grid, so segments are easy to scan at a glance.

Managing taxonomies

You manage taxonomies on the Taxonomies page in the dashboard.

Create a taxonomy — choose New taxonomy, then either:

Start empty and add terms by hand, or
From CSV / paste — seed the terms from a CSV file or pasted rows in one step.

Edit a taxonomy — open it to rename it and manage its terms in a table (external ID, label, color, description). You can add, edit, and delete terms inline.

Bulk import terms — append terms from a CSV file or pasted text. Terms whose external ID already exists are skipped, so you can safely re-import an updated file.

Export — download any taxonomy as a CSV.

The CSV format is the same for import and export:

external_id, label, description (optional), color (optional: gray, red, orange, yellow, green, blue, purple, pink)

Using a taxonomy on a field

Taxonomies become useful when you connect one to a field:

Open a choice or multi-choice section in the Section editor.
For its option source, switch from inline to From taxonomy and pick the taxonomy.
That field’s selectable options now come from the taxonomy’s terms.

From then on, editing the taxonomy updates the field everywhere it’s used — you don’t maintain the option list on each field separately. AI generation that fills a choice field picks from these same options, so generated values stay within your controlled list.