Getting Started with Tidy Related Posts

This guide walks you through installing Tidy Related Posts, configuring the similarity algorithm, and displaying related content to keep visitors engaged.

1. System Requirements

Before installing Tidy Related Posts, make sure your WordPress environment meets the following requirements:

  • WordPress 6.0 or higher — Tidy Related Posts uses the Block API and modern REST endpoints. We recommend running the latest version.
  • PHP 8.2 or higher — The plugin uses modern PHP features including typed properties and enums.

Tidy Related Posts is compatible with all well-coded WordPress themes. The plugin provides template overrides so you can customize the output to match your theme perfectly.

2. Installation

Option A: Install from the WordPress Plugin Directory

  1. In your WordPress admin, go to Plugins → Add New.
  2. Search for "Tidy Related Posts" in the search bar.
  3. Click Install Now next to the Tidy Related Posts plugin.
  4. Once installed, click Activate.

Option B: Manual Upload

  1. Download the Tidy Related Posts plugin ZIP file from your account dashboard or the WordPress plugin directory.
  2. In your WordPress admin, go to Plugins → Add New → Upload Plugin.
  3. Choose the ZIP file and click Install Now.
  4. Once installed, click Activate.

After activation, you will see a new "Related Posts" menu item in your WordPress admin sidebar. Navigate to Related Posts → Settings to configure the plugin.

3. Configuration

Navigate to Related Posts → Settings in your WordPress admin. Here you can configure how related posts are calculated and displayed.

Similarity Settings

Tidy Related Posts uses the Jaccard index to calculate similarity between posts based on their shared taxonomies (categories and tags). The algorithm compares the taxonomy terms of each post pair and produces a score between 0 and 1. Posts with the highest scores are shown as related.

  • Number of related posts — How many related posts to display (default: 4).
  • Taxonomies to use — Choose which taxonomies are used for similarity calculation. By default, both categories and tags are used.

Display Settings

  • Layout — Choose from 4 display layouts: list, cards, grid, or minimal.
  • Show thumbnails — Toggle featured image thumbnails on or off.
  • Show excerpt — Display a short excerpt below each related post title.
  • Auto-insert — Automatically append related posts below your content, or use manual placement with the Gutenberg block or shortcode.

4. Displaying Related Posts

There are multiple ways to display related posts on your site:

Automatic Insertion

Enable auto-insert in the settings and related posts will automatically appear below your post content. No additional setup required.

Gutenberg Block

Add the Tidy Related Posts block anywhere in the editor. The block renders server-side, showing a live preview of related posts. You can customize the layout and number of posts per block.

Shortcode

Use the [smart_related_posts] shortcode in the classic editor or any shortcode-enabled area. You can pass attributes like [smart_related_posts count="6" layout="grid"].

Editor Sidebar

When editing a post, the Tidy Related Posts sidebar panel shows the calculated related posts and lets you insert internal links to them directly into your content, improving your internal linking structure.

5. Internal Link Audit

Navigate to Related Posts → Link Audit to access the internal link audit dashboard. This tool scans your content and shows which posts have few or no internal links, helping you identify opportunities to improve your site structure and SEO.

6. Performance

Tidy Related Posts is designed for performance. Similarity scores are computed via WP-Cron batch processing and stored in the database. Results are cached using WordPress transients, so related posts are served instantly without recalculation on each page load.

You can also override the plugin templates in your theme by copying them to a tidy-related-posts/ directory in your theme folder.