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

# Taxonomies

![Studio Taxonomies page listing a hierarchical taxonomy with its version and status](https://mintcdn.com/mixpeek/Wd_dr3_jo8gqgFxV/assets/studio/taxonomies.png?fit=max\&auto=format\&n=Wd_dr3_jo8gqgFxV\&q=85\&s=f799891c61c30d01e39487fc991f3438)

The Taxonomies page — hierarchical and flat taxonomies used to enrich documents.

[Taxonomies](https://d8ts56gtwtyh1.cloudfront.net/docs/warehouse/taxonomies.mp4)

Taxonomies provide warehouse-native enrichment, the multimodal equivalent of a SQL JOIN.

### Create and apply taxonomies

* **Create**: Click New Taxonomy, choose flat or hierarchical, and define config. API parity: [Create Taxonomy](https://docs.mixpeek.com/docs/api-reference/taxonomies/create-taxonomy.md).
* **Flat**: Join a source collection to a taxonomy collection via a retriever. Configure input mappings and enrichment fields.
* **Hierarchical**: Define nodes explicitly or infer via schema, clusters, or LLM. Per-node retrievers and input mappings are supported.
* **Execute on-demand**: Validate configs against sample documents. API: [Test Taxonomy](https://docs.mixpeek.com/docs/api-reference/taxonomies/test-taxonomy-configuration-validation-only.md). Note this is for testing only; on-demand enrichment typically happens inside retrievers.
* **Materialize**: Attach to collections with `execution_mode` set to materialize so Engine enriches after ingestion. Manage under Collections → Taxonomy Applications. API: [Update Collection](https://docs.mixpeek.com/docs/api-reference/collections/update-collection.md).
* **Versions**: Snapshot configurations and browse history. API: [Create Version](https://docs.mixpeek.com/docs/api-reference/taxonomies/create-taxonomy-version.md), [List Versions](https://docs.mixpeek.com/docs/api-reference/taxonomies/list-taxonomy-versions.md).
* **Manage**: Get, list, or delete taxonomies. API: [Get](https://docs.mixpeek.com/docs/api-reference/taxonomies/get-taxonomy.md), [List](https://docs.mixpeek.com/docs/api-reference/taxonomies/list-taxonomies.md), [Delete](https://docs.mixpeek.com/docs/api-reference/taxonomies/delete-taxonomy.md).

### Tips

* Use on-demand for interactive retrieval flows and materialize for post-ingestion enrichment.
* Keep enrichment fields minimal to avoid payload bloat; prefer app-side joins when possible.

> [tab] Flat
>
> **1. Create**
>
> Select retriever, input mappings, and source collection.
>
> **2. Validate**
>
> Use Execute for on-demand checks with sample docs.
>
> **3. Apply**
>
> Attach to a collection as on-demand or materialize.

> [tab] Hierarchical
>
> **1. Define or infer**
>
> Add nodes or choose schema/cluster/LLM inference.
>
> **2. Per-node options**
>
> Override retriever and input mappings as needed.
>
> **3. Version**
>
> Snapshot configs and track changes over time.

Materialized enrichments are executed by the Engine post-ingestion—no separate API call is needed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.