Categories

Organize content with taxonomies

Categories let you classify and organize your content. They're used for filtering, navigation, and grouping related posts together.

For example:

• A blog might use categories like "Technology", "Design", "Business"
• A product catalog might use "Electronics", "Clothing", "Home & Garden"
• A portfolio might use "Web Design", "Branding", "Mobile Apps"

Categories are defined per post type, so each content model can have its own set of category types.

Multiple taxonomies per post type

A category type defines a taxonomy system. Each post type can have multiple category types. For example, a blog post type could have:

• Topics — Technology, Design, Business
• Tags — JavaScript, React, CSS, UX
• Difficulty — Beginner, Intermediate, Advanced

When creating a category type, you configure:

• Title — display name for this taxonomy
• Multi-select — whether posts can belong to multiple categories in this type
• Required — whether every post must have at least one category selected
• Hierarchy — whether categories can have parent-child relationships

Nested category trees

When hierarchy is enabled on a category type, categories can be nested under parent categories:

• Electronics → Phones → Smartphones
• Services → Development → Frontend

This creates a tree structure that's useful for complex taxonomies. The API returns the full hierarchy, so your frontend can display category trees, breadcrumbs, and nested navigation.

Icons and thumbnails

Categories can have visual elements:

• Thumbnails — upload an image to represent the category (useful for visual navigation or featured category sections)
• Icons — assign an icon for compact UI representations

These visual elements are returned through the API, so your frontend can display rich category listings with images or icons.

Assigning and filtering

Once configured, categories appear in the post editor sidebar where editors can assign categories to each post.

On the frontend, categories enable:

• Filtering — show only posts in a specific category
• Navigation — build category-based menus and sidebars
• Related content — find posts that share the same categories
• Dynamic listings — use DynamicCategory sections to create filterable content grids

The GraphQL API supports filtering posts by one or multiple categories, making it easy to build category-based pages and navigation.