Taxonomy terms
Display the terms of a taxonomy, like categories or tags.
The Taxonomy Terms block lists the terms of a taxonomy, the categories, tags, or a custom taxonomy attached to your content. It works like a query, but over terms instead of posts.
You design the layout for a single term, and it repeats for each one, useful for a category index or a tag list.
Adding one
- Select the section or container to hold it.
- Open the inserter and search "taxonomy-terms".
- Pick the Taxonomy Terms block.
Settings
In the block's own panel. Appearance lives in the shared design panel.
| Setting | What it does | Reach for it when |
|---|---|---|
| Source | Which taxonomy to pull from, a built-in like categories or tags, or a custom taxonomy | Whenever the default taxonomy is not the one you want |
| Post type | Limits terms to those used by a specific post type | Your site has multiple post types sharing a taxonomy and you only want terms from one |
| Taxonomies | Picks the specific taxonomy within the selected post type | The post type registers more than one taxonomy |
| Number | How many terms to show | You want a fixed count, like the top five categories |
| Order by | Sort order, name, count, slug, term group, or ID | Showing most-used tags, or alphabetical browse pages |
| Order direction | Ascending or descending | Reversing a count sort to show least-used first |
| Top parents only | Shows only root-level terms, skipping children | Hierarchical taxonomies where you want the top-level list |
| Exclude | Specific terms to leave out | Removing an uncategorised catch-all from a public listing |
| Include | Specific terms to show, ignoring the rest | Curating a hand-picked subset |
| Exclude current | Hides the term that matches the current archive page | Useful inside a taxonomy archive so the page does not list itself |
| Exclude children | Shows parent terms only, regardless of hierarchy depth | Flattening a deep taxonomy for a summary view |
| Hide empty | Skips terms with no posts assigned; on by default | Turn off if you want to list all terms even before content exists |
Styling
The block uses the shared design panel for spacing, type, colour, borders, and effects, each per breakpoint. Because the block repeats its inner template per term, style the inner blocks to control how each term card or label looks, and use the states panel to set hover styles on links or cards within the template.
Accessibility
Each term in the output is typically a link to that term's archive. Write the inner link text so it names the term clearly rather than relying on surrounding context, since screen readers can navigate links as a list. If you add a count or decorative element beside the term name, keep the link text itself descriptive and do not rely on the count alone to convey meaning.