Get Ariadne

Docs /

Installing and Activating Ariadne

Get Ariadne Related Posts running on your WordPress site in a few minutes.

Requirements

  • WordPress 6.0 or later
  • PHP 7.4 or later
  • A Voyage AI API key — only needed if you want AI-powered semantic matching (Pro and Pro+). Everything else works without one.

Installing the Free version

  1. From your WordPress dashboard, go to Plugins → Add New and search for “Ariadne Related Posts,” or download the plugin and upload the ariadne-related-posts folder to /wp-content/plugins/.
  2. Activate it from the Plugins screen.
  3. Go to Settings → Ariadne Related Posts to review the default matching weights and, if you want AI-powered matching, add your Voyage AI key.

That’s it — Ariadne starts computing related lists for your existing posts in the background right away. See where related posts show up by default for what to expect next.

Installing Pro or Pro+

Pro and Pro+ are distributed directly rather than through WordPress.org. After purchase, you’ll get a plugin file to upload the same way as above, plus a license key. Activating that key (Settings → Ariadne Related Posts → license) unlocks the paid features immediately — nothing else about the install process changes.

If you’re upgrading from Free, your existing settings, scoring history, and cached related lists carry over. You won’t need to reconfigure anything.

Adding your Voyage AI key

This step is only needed for AI-powered matching (Pro and Pro+). There are two ways to set it:

  • Recommended: add define( 'ARP_VOYAGE_API_KEY', 'your-key-here' ); to your site’s wp-config.php. This keeps the key out of the database entirely.
  • Simpler: paste it directly into the field on the Settings screen. Ariadne never displays a saved key back to you afterward — leaving the field blank on a later save keeps the existing key rather than clearing it.

Without a key, Ariadne still works well: tag, category, and title matching, plus local text-similarity scoring, all function normally. Only the semantic-understanding part of body matching is skipped. See do you need an AI API key? for more on what that actually changes.

Back← What is Ariadne?
NextWhere related posts show up by default →