Title: Juanjo Labs Semantic Related Posts
Author: Juanjo Labs
Published: <strong>September 3, 2026</strong>
Last modified: September 3, 2026

---

Search plugins

![](https://ps.w.org/juanjo-labs-semantic-related-posts/assets/icon-256x256.png?
rev=3680232)

# Juanjo Labs Semantic Related Posts

 By [Juanjo Labs](https://profiles.wordpress.org/juanjolabs/)

[Download](https://downloads.wordpress.org/plugin/juanjo-labs-semantic-related-posts.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/juanjo-labs-semantic-related-posts/#description)
 * [Reviews](https://wordpress.org/plugins/juanjo-labs-semantic-related-posts/#reviews)
 *  [Installation](https://wordpress.org/plugins/juanjo-labs-semantic-related-posts/#installation)
 * [Development](https://wordpress.org/plugins/juanjo-labs-semantic-related-posts/#developers)

 [Support](https://wordpress.org/support/plugin/juanjo-labs-semantic-related-posts/)

## Description

**Juanjo Labs Semantic Related Posts** shows related articles using **real semantic
similarity** (AI embeddings), not just shared tags or categories like most related-
posts plugins.

Why does this matter? A traditional related-posts plugin only compares shared tags
and categories. This plugin understands what each article is actually _about_ and
finds genuinely similar content, even if it doesn’t share a single tag.

#### 4 matching modes, not just AI

Pick whichever mode fits your site best — all four are available in both Lite and
Pro:

 * **AI semantic** — embeddings, finds real similarity of meaning
 * **By category** — most recent posts from the same category
 * **By tags** — posts sharing the most tags with the current one
 * **Hybrid** — combines tags + category, with AI re-ranking if an API key is configured

#### Lite version features (free)

 * All 4 matching modes (AI, category, tags, hybrid)
 * Embeddings generated from each post’s title and excerpt (AI mode)
 * Unlimited posts indexed with AI
 * Choose which public post types are included (posts, pages, WooCommerce products,
   other custom post types) — with automatic price display for products
 * 1 widget style (simple grid)
 * Manual embeddings recalculation
 * Basic SEO metadata for Rank Math (title, description and ALT generated by rules,
   no API cost)

#### With the Pro version you get

 * Embeddings over the full post content (higher accuracy in AI mode)
 * Automatic recalculation via cron (Lite is manual, on demand)
 * 3 widget styles (Grid, List, Compact) and a customizable accent color
 * Dedicated WooCommerce integration hook for classic themes where the product page
   doesn’t run `the_content` (covers cases the standard content filter misses)
 * Manual post exclusion and per-category weight control
 * SEO metadata generated with real AI (Claude) for Rank Math: title, description
   and image ALT text
 * Priority email support

Upgrade to Pro anytime from the plugin’s settings page in your WordPress admin (
Settings  Semantic Related Posts  Licencia).

#### Use cases

 * Blogs and news sites that want to reduce bounce rate
 * E-commerce sites with products related by real description, not just category
 * Multilingual sites that need an alternative to English-only plugins

### External services

This plugin connects to third-party AI APIs to provide its core features. You must
supply your own API key for each service you want to use; the plugin never sends
data to these services without a key configured, and none of your API keys are ever
sent to us (Juanjo Labs) or to any server other than the provider’s own.

**Voyage AI (embeddings)** — used to generate the semantic embeddings that power
the “AI semantic” and “Hybrid” related-posts modes.
 It sends the title and excerpt
of each published post (and, in the Pro version, the full post content) to Voyage
AI’s API whenever a post is created or updated and an API key is configured. No 
data is sent if this mode isn’t in use or no API key is set. Provider: Voyage AI
Innovations, Inc. — [Terms of Service](https://www.voyageai.com/tos) — [Privacy Policy](https://www.voyageai.com/privacy)

**Anthropic API (Claude)** — used only in the Pro version, to generate SEO metadata(
title, description, focus keyword) and image ALT text for Rank Math.
 It sends the
post’s title and content (for metadata) or an image’s binary data (for ALT text)
to Anthropic’s API when you use the “Generate SEO” tools and an Anthropic API key
is configured. No data is sent if no API key is set, or in the Lite version, which
generates this metadata locally using simple rules instead. Provider: Anthropic,
PBC — [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms)—
[Privacy Policy](https://www.anthropic.com/legal/privacy)

## Installation

 1. Upload the `juanjo-labs-semantic-related-posts` folder to `/wp-content/plugins/`
 2. Activate the plugin from the “Plugins” menu in WordPress
 3. Go to Settings  Semantic Related Posts and generate the initial embeddings
 4. Insert the `[semantic_related_posts]` shortcode, or use the included block/widget

## FAQ

### Do I need an external API key?

Yes, the AI matching mode uses Voyage AI’s embeddings API — you supply your own 
key, and Voyage AI’s own free tier includes a monthly quota (set by Voyage AI, not
by this plugin). The category, tags, and hybrid-without-API-key modes don’t require
any external key.

### Does it work with any WordPress theme?

Yes, the widget adapts to your theme’s styles and can be inserted via shortcode,
Gutenberg block, or classic widget.

On sites with **WooCommerce**: if you include “Products” under Settings  Semantic
Related Posts  Tipos de contenido, the widget inserts automatically on product pages
the same way it does on posts, on any theme that runs `the_content` for the product
description (Storefront, Astra, Flatsome, OceanWP, and most themes used with WooCommerce
in production). The **Pro** version adds a dedicated WooCommerce hook that also 
covers classic themes where the product has no long description (so `the_content`
never runs). On **fully block-based themes with WooCommerce Blocks** (for example,
Twenty Twenty-Four), automatic insertion doesn’t work on either version because 
of how those themes rebuild the product page — in that case, manually add a “Custom
HTML” block with the `[semantic_related_posts]` shortcode to the product template(
Appearance  Site Editor  Templates  Single Product). The shortcode works correctly
on any theme, including block themes.

### What’s the difference between Lite and Pro?

Both versions include all 4 matching modes (AI, category, tags, hybrid), unlimited
AI indexing, the ability to include any public post type (including WooCommerce 
products), and SEO metadata generation for Rank Math. Lite uses title + excerpt 
for AI mode and rule-based SEO metadata, generated manually. Pro adds embeddings
over the full post content (higher accuracy), automatic recalculation via cron, 
real AI-generated (Claude) SEO metadata, 3 widget styles, a dedicated WooCommerce
integration hook for classic themes, manual post exclusion, and per-category weighting.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Juanjo Labs Semantic Related Posts” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ Juanjo Labs ](https://profiles.wordpress.org/juanjolabs/)
 *   [ Freemius ](https://profiles.wordpress.org/freemius/)

[Translate “Juanjo Labs Semantic Related Posts” into your language.](https://translate.wordpress.org/projects/wp-plugins/juanjo-labs-semantic-related-posts)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/juanjo-labs-semantic-related-posts/),
check out the [SVN repository](https://plugins.svn.wordpress.org/juanjo-labs-semantic-related-posts/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/juanjo-labs-semantic-related-posts/)
by [RSS](https://plugins.trac.wordpress.org/log/juanjo-labs-semantic-related-posts/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release

## Meta

 *  Version **1.0.0**
 *  Last updated **17 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.0.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [AI](https://wordpress.org/plugins/tags/ai/)[embeddings](https://wordpress.org/plugins/tags/embeddings/)
   [related posts](https://wordpress.org/plugins/tags/related-posts/)[semantic search](https://wordpress.org/plugins/tags/semantic-search/)
   [seo](https://wordpress.org/plugins/tags/seo/)
 *  [Advanced View](https://wordpress.org/plugins/juanjo-labs-semantic-related-posts/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/juanjo-labs-semantic-related-posts/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/juanjo-labs-semantic-related-posts/reviews/)

## Contributors

 *   [ Juanjo Labs ](https://profiles.wordpress.org/juanjolabs/)
 *   [ Freemius ](https://profiles.wordpress.org/freemius/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/juanjo-labs-semantic-related-posts/)