Uwawp The most common placement and freshness issues, and how to fix each one.
Related posts appearing twice on the same page
This almost always means a manual placement (block, shortcode, or widget) exists on a post that also has auto-insert turned on. Ariadne is designed to detect a manual placement and skip the automatic one — if you’re still seeing it twice, check:
- Whether the post’s content actually contains the block or shortcode more than once
- Whether a theme template file also outputs something similar independently of Ariadne (uncommon, but worth ruling out on a heavily customized theme)
- On a Pro/Pro+ site using inline related posts, whether the same post is appearing both inline and in the end-of-content block — these are meant to exclude each other automatically, so this specific combination is worth reporting if you see it
A related list that doesn’t seem to update
Related lists refresh in the background, not instantly on every change. A few specific triggers to know about:
- Changing a matching weight (Settings → Matching) marks every post’s list as needing a refresh, sitewide. This is a background process, not instant — a large site can take a while to fully re-sweep.
- Trashing a post that showed up in other posts’ related lists triggers those lists to refresh and backfill a replacement automatically, again in the background rather than instantly.
- A page-caching plugin or a full-site cache can serve an older cached version of a page, including its related-posts markup, until that specific page’s cache expires or is cleared. If a list looks stale but the post-edit meta box already shows the updated version, this is almost always the explanation — clear your site’s page cache for that URL.
Speeding up a slow-feeling refresh
On a quiet site with little traffic, background jobs still continue running on their own rather than waiting for a visitor to trigger the next batch. If something still feels slower than expected, the Post Status screen’s “catch up now” action (Pro and Pro+) or WP-CLI‘s recompute command can nudge a specific post or the whole queue along immediately.