Taxonomies & Terms

Taxonomies help you organize content using shared terms that can be applied across many entries.

Common examples include:

• categories
• tags
• topics
• sections
• authors
• content types

When to use a taxonomy

Use a taxonomy when the same label or classification needs to be reused across multiple entries.

For example, instead of typing a category name manually into every entry, you can define it once as a taxonomy term and select it wherever needed. This keeps content more consistent and makes it easier to filter, group, and query later.

Create a taxonomy

To create a taxonomy:

1. Go to Models → Taxonomies.
2. Click Create Taxonomy.
3. Enter a name for the taxonomy.
4. Review the generated API ID, if needed.
5. Save the taxonomy.

Add terms

Once the taxonomy has been created, add the terms editors should be able to choose from.

For example, if you create a Category taxonomy, you might add terms such as News, Opinion, and Guides.

The exact workflow for managing terms may vary depending on your project setup, but the goal is the same: define reusable options once, then apply them consistently across your content.

Use a taxonomy in a content model

In the taxonomy editor, configure Applies to so the taxonomy is available on specific content models, or leave it empty to allow all content models (same behavior as the entry editor sidebar).

Editors assign terms from the entry sidebar in the Studio. You do not add a separate reference field on the content model.

Query assigned terms (GraphQL)

When a taxonomy applies to a model, the Delivery GraphQL Entry_* type includes a list field named from the taxonomy plural API ID (camelCase). For API IDs Tag / Tags on BlogPost, request tags:

query {
  blogPost(id: "entry-id-here") {
    _id
    title
    tags {
      _id
      name
    }
  }
}

You can list taxonomy terms at the root (tags, tag) and filter entry collections with where on plural queries (singular taxonomy API ID, e.g. where: { tag: { … } }). See GraphQL API.

Next steps

• Content Models
• Components