Skip to content

How To Add Taxonomy Listing in WordPress?

Key Takeaways

  • Nexter Blocks Taxonomy Listing block lists post category, tag, product category, product tag, and custom taxonomies in WordPress.
  • Taxonomy Listing block requires the default WordPress Block editor, the Nexter Blocks plugin, and the PRO version of Nexter Blocks; it is activated in Nexter → Blocks by turning on the Taxonomy Listing toggle.
  • Taxonomy Listing block offers four layout types: Grid, Masonry, Metro, and Carousel, and Style 1 and Style 2 need a thumbnail image for each taxonomy in the backend to show taxonomy images.
  • Taxonomy Listing block includes query controls such as Include Terms ID, Exclude Terms ID, Hide Empty, Hide Sub Taxonomy, Hide Parent Taxonomy, Offset Taxonomy, Order By options like Random, Id, Author, Title, Date, Modified, and a Custom Query ID.
Table of Contents

Most sites hide their categories in a sidebar list nobody reads. If your content is organised well, that structure is worth showing properly.

The Taxonomy Listing block turns any taxonomy — categories, tags, product categories or one you registered yourself — into a set of linked cards with an image, the term name and its post count.

Before You Start

  • Edition: Pro — the Taxonomy Listing block needs Nexter Blocks Pro.
  • Block to enable: Taxonomy Listing, switched on under Nexter > Blocks in your WordPress dashboard.
  • Terms that exist. The block lists your real taxonomy terms, so a site with one category shows one card.

Steps

  1. Add the Taxonomy Listing block to your page.
Adding the Taxonomy Listing block
  1. Choose the taxonomy you want listed.
Choosing the taxonomy
  1. Pick a layout — grid, masonry, metro or carousel.
Choosing a layout
  1. Set how many terms to show, and the order they appear in.
Item count and ordering
  1. Choose what each card shows, then publish.
Card content settings

Set the image on each term itself, not here. Edit a category and you will find Nexter’s image field on that screen — that is where these cards read from.

How It Behaves

Every card is a link to that term’s archive. Measured on a real site, the first card linked straight to /category/accessibility/, so the listing is a navigation element rather than decoration.

  • The category image comes from Nexter’s own term image field, set on the term itself when you edit it. It is not WordPress’s featured image and, on a product category, it is not WooCommerce’s category image either — those are stored separately and this block does not read them.
  • A term with no image still renders one. Measured: removing a term’s image produced a card showing a generic placeholder shipped with the plugin, not a blank or broken image. That is why missing category images are easy to miss.
  • The post count is shown by default. Measured on an untouched listing: each card rendered its real term count.
  • Descriptions are off by default, and a term with an empty description renders no description element at all even once they are switched on.
  • Empty terms are hidden by default, with one WordPress-level exception: a term with no posts of its own but a child that has posts is kept. Measured, and core WordPress behaves identically, so it is not something this block can change.
  • Type a number into the item count; do not leave it blank. Measured on 5.0.6: a blank field renders one term rather than all of them, and so does 0. Reported to the developers.
  • Any registered taxonomy works. Measured across categories, tags and WooCommerce product categories with no change other than the taxonomy setting.
  • Measured with Nexter Blocks Pro deactivated: the block renders nothing at all — not a wrapper, not a message, zero output. This is a Pro-only block.

Limitations

  • Pro only — measured with Pro deactivated, the block is not registered and renders nothing whatsoever.
  • Term images have to be set one term at a time. There is no bulk way to do it, and a large taxonomy is a long afternoon.
  • A term with no image looks fine but wrong. The placeholder means you will not notice a missed term until someone points at it.
  • It lists terms, not posts. For the posts inside a category, use Post Listing instead.
  • There is no pagination or load more. The item count is the whole list.
  • The item count field must not be left blank, for the reason above.

Troubleshooting

Only one category is showing

The item count is blank or set to zero. Type the number you want. This is the most common cause by a wide margin.

My category images are not appearing

They are read from Nexter’s term image field, set when you edit the term. A WooCommerce category image set in WooCommerce is stored separately and is not used here.

An empty category is still showing

It has a sub-category that does have posts. WordPress keeps the parents of non-empty terms, and core behaves the same way.

The carousel keeps moving while I try to click

Autoplay is on by default and does not pause on hover. Switch it off.

The block disappeared after my licence lapsed

It is a Pro block and renders nothing without Pro active.

Related Docs

Share your Thoughts

Still in Doubt? Let’s Assist You

Have Feedback or Questions?

Join our WordPress Community on Facebook!

Related Frequently Asked Questions

Why is only one category showing in my taxonomy listing?

A blank item count is the usual culprit. The Taxonomy Listing block expects a number there, and on 5.0.6 a blank field or 0 rendered one term instead of the full list. Nexter Blocks Pro also lists only real taxonomy terms, so if your site truly has one category, you will only get one card. That makes the item count field the first thing to check before looking elsewhere.

Why are my category images not appearing in the listing?

The cards read images from Nexter's own term image field on the term edit screen, not from WordPress featured images and not from WooCommerce's category image field. That separation matters because a category can have an image set in WooCommerce and still show nothing here. If an image is missing, the block still renders a generic placeholder, so the problem can be easy to miss.

Why is an empty category still showing in the taxonomy list?

WordPress keeps parent terms visible when a child term has posts, even if the parent itself has none. The Taxonomy Listing block follows that core behavior, so an apparently empty category can still appear because it is acting as a parent for non-empty subcategories. That is normal behavior, not a display bug in Nexter Blocks.

How do I stop the taxonomy carousel from moving while I click items?

Autoplay is on by default, and it does not pause on hover. That means the carousel can keep sliding while you try to click a card or read its label. Switching autoplay off is the practical fix when you want the taxonomy listing to behave more like a navigation strip than a moving banner.

Can I use this block for WooCommerce product categories or custom taxonomies?

The block works with any registered taxonomy, including categories, tags, WooCommerce product categories, and taxonomies you registered yourself. The only thing that changes is which taxonomy you select in the block settings. That makes it useful when you want one consistent card layout across different content structures instead of building separate lists for each one.

What should I use instead if I want posts inside a category rather than the category cards themselves?

Use Post Listing if you want posts inside a term. The Taxonomy Listing block lists terms, not posts, so it is built for navigation into archives rather than showing article content directly. That distinction matters because each card links to its archive page, which makes it better for browsing structure than for displaying post feeds.

Last reviewed: September 27, 2026

Related Docs