WordPress Related Posts Not Showing: Best Fix (2026)
Related posts sections matter more than people realize; they’re one of the simplest ways to keep visitors on your site longer by surfacing content they’re likely to actually want. When WordPress related posts not showing happens, the cause depends heavily on how you’re generating them in the first place (a plugin like Jetpack, a dedicated related posts plugin, or custom code). Here’s how to diagnose and fix it across the most common setups.
Step 1: Identify How Your Related Posts Are Generated
The fix depends entirely on your setup:
- Jetpack’s built-in Related Posts feature
- A dedicated related posts plugin (Contextual Related Posts, YARPP, Related Posts Pro, etc.)
- Custom code using
WP_Queryin your theme
Fix for Jetpack Related Posts
Check it’s actually enabled. Go to Jetpack > Settings > Traffic and confirm “Show related content after posts” is toggled on.
The “shows when logged in, not logged out” bug (commonly overlooked). This specific symptom related posts appearing correctly when you’re logged into WordPress, but disappearing for regular (logged-out) visitors almost always points to a caching issue. Many caching plugins cache logged-out visitor pages more aggressively than logged-in admin views, so you end up looking at a fresh version while visitors see a stale cached version missing the related posts data.
Fix:
- Clear your caching plugin’s full cache completely
- If using a caching plugin, check its settings for any option related to excluding dynamic content (like related posts, which loads via a script call) from aggressive caching
- Test in an incognito window (logged out) after clearing cache to confirm
Check if it’s showing in preview/customizer but not live. Jetpack’s customizer view shows example related posts as a preview, which can be misleading this doesn’t confirm real related posts are working on actual published content. Test on an actual live, published post instead.
Fix for Dedicated Related Posts Plugins
Confirm the plugin’s matching criteria. Most related posts plugins match content by category or tags if a specific post has no matching category/tag overlap with other posts, it may genuinely have nothing to show, which isn’t a bug.
Check for a bug specific to one post, not the whole site. If most posts show related content correctly but one specific post doesn’t, compare its settings against a working post — a mismatched or missing category assignment on that one post is a common, easy-to-miss cause.
Check homepage-specific display settings. Several related posts plugins don’t display on the homepage by default, even when a specific article is set as the featured content there, since homepage display logic is often handled separately from single-post display logic.
Fix for Custom Code (WP Query-Based Related Posts)
If related posts are generated through custom template code rather than a plugin, the most common issue is that the query arguments do not match the current post’s categories.
$categories = wp_get_post_categories( get_the_ID() );
$args = array(
'category__in' => $categories,
'post__not_in' => array( get_the_ID() ),
'posts_per_page' => 4,
);
$related = new WP_Query( $args );
Key detail many implementations get wrong: using wp_get_post_categories() to pull the full list of the current post’s categories (rather than hardcoding a single category ID) ensures the match is based on the post’s actual full category assignment, not just one category this is a common reason related posts queries return irrelevant or empty results.
Step 2: Clear Cache After Any Fix
Regardless of which method you’re using, if you’ve just made a settings or code change, clear your caching plugin’s cache (and CDN cache if applicable) before testing otherwise you may be looking at a stale cached version that doesn’t reflect your fix yet.
Step 3: Check for a Plugin Conflict
If multiple related posts plugins are active simultaneously (common after testing different options), they can conflict with each other.
- Deactivate all but one related posts plugin
- Test display again
- If the issue resolves, the conflict was between competing plugins rather than a configuration problem
Diagnostic Quick Reference of wordpress related posts not showing
| Symptom | Likely Cause | Fix |
|---|---|---|
| Shows when logged in, not logged out | Caching issue | Jetpack fix, Step 1-2 |
| Works for most posts, fails on one specific post | Category/tag mismatch on that post | Dedicated plugin fix |
| Never shows on homepage specifically | Homepage display handled separately | Dedicated plugin fix |
| Custom-coded related posts show wrong/irrelevant results | Query not matching full category list | Custom code fix |
| Multiple related posts features installed, conflicting | Plugin conflict | Step 3 |
Frequently Asked Questions of wordpress related posts not showing
Why do related posts show correctly in preview but not on the published page? Preview/customizer views for features like Jetpack’s related posts often show example content rather than pulling real data always test on an actual published, live post rather than relying on the preview.
Can caching really hide a feature that otherwise works fine? Yes, this is a very real and common cause, specifically for dynamically loaded content like related posts, since logged-in and logged-out visitors are frequently served different cached versions of a page.
Is it normal for some posts to have no related posts at all? Yes, if a post genuinely shares no categories or tags with any other published content, there’s nothing for a category/tag-based matching system to surface this isn’t a bug, though it’s worth reviewing your category structure if it’s happening often.
Should I use a plugin or custom code for related posts? A plugin is faster to set up and sufficient for most sites. Custom code gives more control over exactly how matching works, which is worth it if you need specific logic a plugin doesn’t offer.
Final Thoughts for wordpress related posts not showing
WordPress related posts not showing usually comes down to caching (especially the logged-in-vs-logged-out symptom), a category/tag mismatch, or a plugin conflict. Work through the diagnostic table above to match your specific setup and symptom to the right fix. If your related posts are still misbehaving after trying these steps, get in touch here and I’ll fix it directly.
Recommended Tools & Plugins
Every tool below is something I actually use on client projects, not a random affiliate list.
- Hosting: Cloudways fast, managed WordPress hosting
- Theme: GeneratePress lightweight, built for speed
- Page Builder: Elementor Pro the builder behind most of my client sites
- Forms: WPForms reliable, beginner-friendly form builder
- Directory/Listing Sites: Directorist for business directory or listing projects
- Elementor Add-ons: Crocoblock (JetEngine) for dynamic, database-driven sites
- Keyword Research: Mangools is the SEO tool I use for keyword research
- Backups: UpdraftPlus never launch a site without a backup plan
- Course Platform: Tutor LMS is the LMS plugin
- Free Speed Test: Google PageSpeed Insights is the free tool I use to check real Core Web Vitals data
