Category Loop Block lists your categories, or the terms of any public taxonomy, as a list or grid with linked titles. Use it to build category hubs and recipe indexes. Think of it as a Query Loop for categories instead of posts.
Before you start
- WordPress 5.8 or later
- PHP 7.0 or later
Install
- In your dashboard, go to Plugins → Add New Plugin.
- Click Upload Plugin and choose the plugin zip file.
- Click Install Now, then Activate.
How to use
Add a category loop
- In the block editor, add the Category Loop block. Search for “categories”, “loop”, “grid” or “taxonomy”.
- The block starts with two inner blocks. Category Template holds a Category Title and repeats once for each term. Category No Result holds a “No results found.” paragraph.
- Select the Category Loop block and choose what to show in the sidebar (see Block options below).
- Add any other blocks you want inside Category Template to shape each item.
Terms show up even when no posts are assigned to them.
Choose a list, grid or row layout
Select the Category Template block and use the toolbar buttons: List view, Grid view or Row view. Category Template also supports wide and full alignment, colors, typography and block spacing.
Show subcategories on category archives
Building a category archive template? Turn on Inherit query from template on the Category Loop block. On a category or other taxonomy archive, the block then lists the child terms of the term being viewed.
With Inherit query from template on, the block shows nothing (or your Category No Result content) on any page that isn’t a taxonomy archive.
Show a message when there are no terms
Whatever you put inside Category No Result shows only when the loop finds no terms. If you delete the Category No Result block and nothing is found, the loop outputs nothing at all.
Block options
Category Loop
Under Settings:
- Inherit query from template: use the current archive’s term instead of the settings below. Off by default.
- Taxonomy: which taxonomy to list. Any publicly queryable taxonomy can be chosen. Default is Categories.
- Order by: Newest to oldest, Oldest to newest, A → Z (default) or Z → A.
Under Filters (shown for hierarchical taxonomies like Categories):
- Parent Term: pick one top-level term to list only its direct children. When no parent is set, only top-level terms are shown. The filter resets when you change the taxonomy.
Under Display:
- Maximum items to show: up to 100. Default is 100.
- Offset: the number of items to skip from the start. Default is 0.
The Filters and Display panels are hidden while Inherit query from template is on.
Category Title
- Heading level (toolbar): H1 to H6, or a paragraph. Default is H2.
- Alignment (toolbar): left, center or right text alignment.
- Make category a link: links the title to the term’s archive page. Off by default.
- Open in new tab: shown when the title is a link. Off by default.
- Link Rel: shown when the title is a link. Adds a rel attribute, such as
nofollow. Empty by default.
Category Title also supports colors, typography, margin, padding and borders.
Developer reference
Coming soon: the hooks, filters and functions you can use with this plugin from your theme or a code snippet.
FAQs
Can I use it with tags or a custom taxonomy?
Yes. Pick any publicly queryable taxonomy in Taxonomy. The Parent Term filter only appears for hierarchical taxonomies.
Can I show grandchildren, or all terms at every level?
Not right now. The loop shows one level at a time: top-level terms, or the direct children of one top-level parent.