--- title: "How to Show Related Products on a Product Page in WordPress? (Based on Categories & Tags)" url: https://nexterwp.com/docs/show-related-products-on-a-product-page-in-wordpress/ date: 2023-08-09 modified: 2026-09-22 lang: en author: "Aditya Sharma" description: "A shopper reading a product page is the closest they will get to buying. Sending them nowhere next is the cheapest sale you will ever lose. A related products listing..." image: https://nexterwp.com/wp-content/uploads/2024/05/show-related-products-on-a-product-page-in-wordpress-1024x519.jpg word_count: 502 --- # How to Show Related Products on a Product Page in WordPress? (Based on Categories & Tags) ## Key Takeaways - Nexter Blocks Pro. Product Listing block in related mode reads the current product’s terms and finds other products that share categories, tags, or both. - The current product is excluded, and on a non-product page the related listing renders zero products because there is no current product to match from. - The block is Pro only and depends on taxonomy quality: a product with no categories or tags gets nothing, and broad categories produce weak matches. A shopper reading a product page is the closest they will get to buying. Sending them nowhere next is the cheapest sale you will ever lose. A related products listing shows what else in the catalogue is like the product they are looking at. [LIVE BLOCK LINK](https://nexterwp.com/nexter-blocks/listing/wordpress-product-listing/) ## Before You Start - **Edition:** **Pro** — the Product Listing block needs Nexter Blocks Pro.- **Block to enable:** Product Listing, switched on under **Nexter > Blocks** in your WordPress dashboard.- **WooCommerce active, with published products.** The block reads your real catalogue, so an empty store renders an empty listing.- A **single product template** to put the block in.- **Categories or tags actually assigned** to your products, because that is what the matching uses. ## Steps - Edit your **single product template**. ![The single product template](https://nexterwp.com/wp-content/uploads/2023/08/product-listing-single-related-post-type-both-new.gif) - Add a **Product Listing** block below the product details. - Set the listing type to **related**. - Choose whether to match by category, by tag, or by both. - Set a small count, normally four, then save and open a real product. ## How It Behaves In related mode the block reads the current product's terms and finds others that share them. - **It needs a product page to work.** Measured on an ordinary page, a listing set to related rendered **zero products**, because there is no current product to match from. That is correct behaviour, not a fault.- **Matching is by category or tag**, or both. There is no content analysis, so the quality of the matches depends on how well the catalogue is organised.- **The current product is excluded**, so a shopper is never shown the product they are already looking at.- **Matching on both is broader**, since a product sharing either a category or a tag qualifies.- **Measured with Nexter Blocks Pro deactivated:** the block renders nothing at all — no wrapper, no products, no prices. This is a Pro-only block. ## Limitations - **Pro only** — measured with Nexter Blocks Pro deactivated, nothing renders.- **It is only as good as your taxonomy.** A shop with one category produces related lists that are simply the rest of the shop.- **A product with no categories or tags gets nothing**, so the section can appear empty on some products.- **It cannot rank by relevance or by margin.** Matching products come back in the usual order, not best-match or best-selling first.- **Related is not the same as recommended.** This matches terms, it does not know what sells together. ## Troubleshooting ### The related section is empty Either you are not on a product page, or the product has no categories or tags in common with anything else. Measured: on a non-product page the listing correctly returns nothing. ### The matches are not very related Your categories are too broad. Narrower categories or product tags produce much better matches. ### It shows the product I am viewing It should not. Check the listing type is set to related rather than a normal listing. ### It is empty in the editor Expected. There is no current product in the editor. Open a real product page. ## Related Docs - [Create a WooCommerce product archive page](https://nexterwp.com/docs/create-a-woocommerce-product-archive-page-in-wordpress/)- [Display WooCommerce products by category](https://nexterwp.com/docs/display-woocommerce-products-by-category-in-wordpress/)- [Add product listing in WordPress](https://nexterwp.com/docs/add-product-listing-in-wordpress/)- [Advanced tab settings](https://nexterwp.com/docs/use-advanced-tab-in-nexter-blocks/) ## Frequently Asked Questions **Q: Why is my related products section empty on some product pages?** A: An empty related section usually means the current product has no categories or tags in common with anything else, or you are not actually on a product page. The block matches the current product’s terms, so a product with no assigned taxonomy has nothing to return. On a non-product page, it correctly renders zero products because there is no current product to compare against. **Q: What should I set up before showing related products in WordPress?** A: The block needs a real WooCommerce catalogue to read from, plus published products, categories or tags already assigned, and a single product template to place it in. Nexter Blocks Pro is required because Product Listing is a Pro-only block under Nexter > Blocks. If the store is empty or the taxonomy is missing, the related list will also be empty. **Q: Should I match related products by category, tag, or both?** A: Category matching is usually tighter, while tag matching can widen the pool. Matching on both is broader because a product qualifies if it shares either a category or a tag. That helps when your catalogue is small, but it can also make the results feel less specific if your categories are too broad. **Q: Why does the editor show nothing for related products?** A: That is expected behavior. The editor does not have a current product context, so the related listing has nothing to compare against. The block only works on a real product page, where it can read the current product’s terms and find other products that share them. **Q: Can I use this on a normal WordPress page instead of a product page?** A: No. Related mode needs an actual product page because it reads the current product’s terms to find matches. On an ordinary page, the listing rendered zero products in testing because there was no current product to match from. That makes this feature specific to single product templates, not general content pages. **Q: What is the best way to get better related product matches?** A: Tighter taxonomy gives better results. The page calls out that broad categories produce weak matches, while narrower categories or product tags improve relevance. Since there is no content analysis and no relevance ranking, the quality of the output depends entirely on how well your catalogue is organized.