Ariadne Related Posts – Smart Content Recommendations

By Ucheagwu Onyike

0+ active installationsVersion 1.11.0

Keeps readers on your site longer by showing them the right post to read next, matched on tags, categories, titles and text. No API key.

Description

Ariadne keeps readers on your site longer by showing them the right post to read next. It matches posts by what they really share (tags, categories, title words and the text itself), not just by sitting in the same category.

The free version works on its own, on your own server. There’s no API key, no account and nothing to set up. Activate it, and related posts with thumbnails appear under your articles.

Why site owners use it

  • More pages per visit, longer sessions. Readers who finish an article get a short list of related articles to read next, and Up next offers one more before they leave. Both help lower your bounce rate.
  • Automatic internal links. Each suggestion is a normal link, so older articles keep getting found by readers and search engines.
  • Fast on any host. Lists are worked out in the background when you save a post, never while a page loads. It works with full-page caching and busy sites.
  • Clear about what it does. Each post’s edit screen shows its related list and the score behind each match.

Free features

  • Auto-insert under your post content, with featured-image thumbnails.
  • Or place the list yourself with the block, the [ariadne_related] shortcode or a widget. Change the heading or count for one spot.
  • Smart matching on shared tags, shared categories, title words and full-text similarity. Change how much each one counts.
  • Up next: a link to one more article that appears once a reader is about 60% through a post. It’s a slim bar on phones and a small card on desktop. Choose its size, colors (including a frosted glass style) and the details it shows. It gives readers one more post to read before they leave. It is a real link that search engines can follow, and it never shifts the page.
  • A Dashboard, a Settings screen and a Post Status screen, with light and dark modes.
  • Choose which user role can view the reports.
  • Works with any theme. Turn off the plugin’s own styles if you want to style it yourself with WordPress’s Additional CSS.

How matching works

Each post gets a score against every other post from four local signals:

  • Shared tags: a capped, diminishing-returns overlap score.
  • Shared categories: the same capped-overlap formula, separate from tags.
  • Title overlap: Jaccard similarity of title words, with common words removed.
  • Text similarity: BM25 scoring of each post’s body text, computed and cached on your own server.

Background jobs keep every list up to date in small batches. They carry on by themselves without waiting for site traffic, so a large site finishes its first pass promptly even when it’s quiet.

Pro & Pro+

Pro adds AI matching with Voyage AI embeddings, which understands what a post is about rather than only the words it shares. It’s blended with the free text signal using Reciprocal Rank Fusion. Pro also adds related products for WooCommerce and other post types, full style control with a card style picker, manual pin and exclude, Cornerstone Posts, choosing the exact paragraph the block appears after, and a live preview that scores an unsaved draft.

Pro counts views and read depth for each post, on your own site, and adds Popular posts: the most-read posts in a post’s main category, ranked by the views Ariadne counts on your site. Show them after the article, inside the Related block (as tabs, a strip under the list, or mixed into the list with a “Popular” marker), or anywhere with the Popular posts block, the [ariadne_popular] shortcode or a widget. Popular has its own Article and Sidebar styles, and a category can have its own title, date range, look and accent colour. An Analytics screen shows which related and popular lists readers saw, which posts they clicked and whether they read them. Export it as a PDF report, CSV or JSON.

Pro+ adds related-post boxes placed naturally inside the article body, the All time date range for Popular posts, settings export and import, and WP-CLI. See the in-plugin pricing page for the full list.

Docs and support

External services

This plugin’s own scoring and matching (tags, categories, title overlap, local BM25 text matching) runs entirely locally — no data leaves your site for that. The same is true for view counting, Popular posts and Analytics (all Pro): the counts go only to your own site’s REST API and are stored in your own database. It uses the Freemius SDK for licensing, and two optional pieces load an external resource, under the conditions below:

Freemius (licensing) — this plugin uses the Freemius SDK to manage plugin updates and Pro/Pro+ license activation. It contacts the Freemius API (api.freemius.com) to check your license status and deliver updates; on activation, Freemius shows its own opt-in screen asking permission before any anonymous, non-personal diagnostic data (e.g. site URL, plugin/WordPress/PHP versions) is shared — this is optional and declining it does not affect the plugin’s functionality. See Freemius’s Privacy Policy: https://freemius.com/privacy/ and Terms of Service: https://freemius.com/terms/

Google Fonts (Pro/Pro+ only) — this plugin’s own Dashboard, Settings, and Post Status admin screens use your system’s font — nothing is requested from Google for those. Separately, if a Pro/Pro+ license is active and a site owner selects one of the curated Google Fonts for the related-posts card styling (Customizer), that one font family is requested from Google’s font CDN (fonts.googleapis.com) on your site’s frontend. No data beyond the standard browser request (e.g. IP address, user agent) is sent to Google. See Google’s Privacy Policy: https://policies.google.com/privacy and Google Fonts’ own privacy FAQ: https://developers.google.com/fonts/faq/privacy

Voyage AI (Pro/Pro+ only) — if a Pro/Pro+ license is active and a site owner has entered their own Voyage AI API key, this plugin sends each post’s title and body text to the Voyage AI API (https://voyageai.com) once, when that post is saved and its content has changed, to compute a semantic-embedding vector used for the AI-matching signal. This is entirely opt-in (no key = no calls) and uses the site owner’s own account and key, not a shared or plugin-provided one. See Voyage AI’s Terms of Service: https://www.voyageai.com/tos and Privacy Policy: https://www.voyageai.com/privacy

Installation

  1. Upload the ariadne-related-posts folder to /wp-content/plugins/.
  2. Activate the plugin through the “Plugins” screen in WordPress.
  3. Visit Settings → Ariadne Related Posts to adjust scoring weights, or just leave the defaults — it works immediately with zero configuration.

FAQ

How is this different from showing posts from the same category?

Category-only plugins treat every post in a category as equally related. Ariadne scores each pair of posts on shared tags, categories, title words and text, so the closest matches come first. You can see the score for each match on the post’s edit screen.

Does it work with caching plugins?

Yes. Related lists are stored with each post and read from that store when the page is built. Nothing is calculated during the page load, so it works with full-page caching, object caching and CDNs.

I’m switching from another related posts plugin. What do I need to do?

Deactivate the old plugin and activate Ariadne. It builds related lists for your published posts in the background, and the Dashboard shows its progress. If you placed the old plugin’s shortcode by hand, replace it with [ariadne_related] or the block.

Does this call any external service?

Not in the free version. Every signal (tags, categories, title overlap, and local BM25 text matching) is computed locally, with no external API calls, no account, and nothing to configure. Pro adds an optional AI-powered semantic-matching signal, which does call a third-party API (Voyage AI) using your own API key — entirely opt-in, and the plugin works fully without it.

Does Ariadne count views? Can I turn it off?

Only in Pro. The free plugin counts nothing. In Pro, counting is on by default, and you can turn it off. When a visitor leaves a post, a small script (about 1 KB, loaded with defer) tells your own site that the post was read and how far down the visitor scrolled, in steps of 25%. It only counts visits that lasted at least 5 seconds, and it skips logged-in editors and obvious bots. Ariadne keeps daily totals per post, in a table in your own database, for 90 days by default; “Keep data for” (Settings → Popular) can change that. It sends nothing to any other service, sets no cookies, and stores no IP addresses or browser details. The counts rank Popular posts, appear on Post Status and Analytics, and break near-ties in related lists. To stop counting, untick Settings → Matching → Views. Ariadne also adds a suggested paragraph to WordPress’s privacy policy guide (Settings → Privacy).

What does Ariadne count?

The free plugin counts nothing. Pro counts views and read depth (how far down the post the reader got, in steps of 25%). It also counts, for each related and popular list, how often it was seen, which cards were clicked, and whether the reader then read the post they clicked, and how far. Pro uses these counts for Popular posts and the Analytics screen.

Only daily totals per post are stored, in your own database. There are no cookies, and no IP addresses or browser details (user agent) are stored. Nothing is sent to any other service. To link a click to the read that follows, the Pro script keeps one short note in that browser tab’s session storage for up to 30 minutes, and deletes it once used. If you use a consent plugin that supports the WP Consent API, that note is only kept after the visitor allows statistics.

In Pro, “Keep data for” (Settings → Popular) sets how long daily totals are kept: 30, 90, 180 or 365 days. After that, only month totals are kept. Turn off “Count clicks” there to stop counting lists and clicks.

What happens to Popular posts and Analytics if my Pro licence ends?

Popular blocks, shortcodes and widgets you placed keep showing, with their saved settings and category styles. You can’t change those settings until the licence is active again. New views and clicks are no longer counted. The counts you already have stay: Popular keeps ranking by them, and the Analytics screen stays readable and exportable.

Does this slow down my site?

No. Nothing is ever scored at page-render time. Every related-post list is precomputed in the background (in small, budgeted batches) and simply read from a cache when a page loads.

Can I control where the related-posts block appears?

Yes — auto-insert after your content, or place it yourself anywhere with the [ariadne_related] shortcode, the Gutenberg block, or a widget. (Pro adds choosing the exact paragraph it lands after, and Pro+ adds boxes placed naturally inside the article body.)

What happens to my settings if I downgrade from Pro/Pro+?

Nothing is lost. Anything that depends on a Pro/Pro+ feature (custom styling, pinned posts, etc.) simply stops being applied while locked — the underlying data stays saved, and everything picks back up automatically if you upgrade again.

Screenshots

Changelog

1.11.0

Ariadne 1.11.0 adds Popular posts, an Analytics screen and a style library (Pro), and makes related lists better and faster for everyone.

New in Pro
* A style library for the Related block and the boxes inside the article: Read also, Text line, Rich link, Arrow card, Profile chip, Series strip and Float beside. Multi-post units too: Text list, Thumb list, 2-up, 3-up, Lead + links, Numbered list and Chip row.
* Mark a tag as a story series, and the Series strip shows the parts of the story in date order.
* Six new Up next looks: Pill, Progress line, Edge tab, Read next card, Text bar and Two picks. A Story series switch links to the next part of a story. The corner card stays free and the default.
* Popular posts: the most-read posts in a post’s main category, titled “Popular posts” by default. Show them after the article, inside the Related block (tabs, a strip, or mixed in with a “Popular” marker), or anywhere with a block, the [ariadne_popular] shortcode or a widget. They can use the style library too.
* Popular date ranges Today, 7, 30 and 90 days, plus All time on Pro+. Article and Sidebar styles with five looks, and per-category styles.
* View and read-depth counts per post, kept on your own site. They rank Popular posts, show on Post Status and Analytics, and break near-ties in related lists. You can turn them off.
* An Analytics screen: do readers click your lists, and do they stay to read the post they open? Summary, clicks per day, a card per block, best lists and lists to check, and a page per post. Export as a branded PDF report, CSV or JSON.
* wp ariadne recompute pauses while the server is busy (--max-load, default 1.5) and skips posts the background job already did.

Better for everyone
* “Recompute all” and other big rebuilds run about three times faster, with exactly the same related lists.
* Better matches on large sites: many more posts are checked before the list is picked.
* Title words most of your posts share (like “2026”) no longer make unrelated posts look alike.
* A post the article already links to is no longer suggested again in its related list.
* Building related lists uses less memory.
* Small (i) help tips in the Customizer, and plainer help text in Settings, the post box, the block and the widget. Match scores read “60.0% match”.
* In the free version, each Pro feature has one short note with a “Learn more” link.
* The admin screens have a plain, neutral background in light and dark.

Fixes
* With Redis or another persistent cache (Pro), a post could be matched with its old AI vector after an update.
* On a post with no excerpt of its own, the automatic excerpt no longer builds the related lists.
* In the block editor, the Related Posts block preview now shows your card styles.
* On a post with no image, the rank number no longer covers the letters on its placeholder image.
* On a phone, the Card details tab under Settings no longer scrolls the whole page sideways.

Privacy
The new counts stay on your site: daily totals only, no cookies, no IP addresses, nothing sent elsewhere. You choose how long daily totals are kept (30 to 365 days).

Older versions and the full 1.11.0 notes: https://uwawp.com/docs/changelog/