Type: Free
Purpose: Displays a list of semantically related articles, helping readers discover more relevant content based on meaning rather than tags or categories.
What It Does
At a configurable position in the post (before or after content), visitors are shown a selection of related posts. Unlike traditional related-post plugins that match by shared tags or categories, Supercharger uses vector embeddings to find articles that are genuinely similar in topic and meaning — even if they share no tags at all.
Requirement
This module requires an OpenAI API key configured for embeddings, and the content must be indexed. See Understanding Indexing.
How It Works
During indexing, every post is converted into a vector embedding. When a post is displayed, Supercharger searches the vector database for posts with the most similar embeddings and presents them as recommendations. Results can optionally be cached to avoid repeated database lookups on every page load.
Settings
General
| Setting | Description | Default |
|---|---|---|
| Auto-Insert Recommendations | Automatically inject the widget into post content | Enabled |
| Position | Before or after the post content | After content |
| Number of Recommendations | How many related posts to show (1–20) | 2 |
| Minimum Similarity Threshold | Minimum semantic similarity score (0.0–1.0). Lower values return more results. | 0.25 |
| Cache Recommendations | Cache results to reduce database lookups | Disabled |
| Cache Duration | How long to cache results (minutes) | 60 |
| Avoid Duplicate Posts | Don’t show posts already shown by another recommendation module | Disabled |
| Exclude Terms | Comma-separated term IDs to exclude from results | — |
| Exclude Posts | Comma-separated post IDs to exclude | — |
| Results Offset | Skip the first N results (useful for staggering with other modules) | 0 |
| Filter by Time Frame | Limit results to posts published within a time window (e.g., 2 months) | — |
Display
| Setting | Description | Default |
|---|---|---|
| Widget Title | Heading shown above the recommendations | Related Posts |
| Widget Title Tag | HTML heading tag (h2-h6, div, p) | h2 |
| Layout | list or grid | list |
| Show Thumbnail | Display post featured images | Enabled |
| Thumbnail Aspect Ratio | Image crop ratio | 16/9 |
| Show Date | Display post date | Enabled |
| Date Format | Default, relative, short, long, numeric, or custom | Default |
| Show Similarity Score | Show the semantic relevance score next to each result | Enabled |
| Show Excerpt | Show a short post excerpt | Enabled |
| Excerpt Length | Word count for displayed excerpts | 25 words |
| Meta Fields | Additional info to show: author, categories, tags, comment count, reading time | — |
Tips
- If you see zero recommendations, try lowering the similarity threshold.
- Use Avoid Duplicate Posts when running multiple recommendation modules on the same page.
- New posts appear in recommendations only after the indexing cron has processed them.