Frequently Asked Questions
Answers to common questions about Tidy Related Posts.
How does the similarity algorithm work?
Tidy Related Posts uses the Jaccard index to measure similarity between posts. For each pair of posts, the plugin compares their shared taxonomy terms (categories and tags) and calculates a score: the number of shared terms divided by the total number of unique terms across both posts. A score of 1 means identical taxonomies; 0 means no overlap. Posts with the highest scores are displayed as related.
What display layouts are available?
Tidy Related Posts offers 4 built-in layouts: list (a simple vertical list with titles and optional thumbnails), cards (a card-based layout with featured images and excerpts), grid (a responsive grid ideal for image-heavy sites), and minimal (titles only, no images or excerpts). You can choose the default layout in the settings or override it per block/shortcode.
Is there a shortcode available?
Yes. Use the [smart_related_posts] shortcode anywhere shortcodes are supported. You can pass attributes to customize the output, for example: [smart_related_posts count="6" layout="grid"]. The shortcode accepts the same options as the Gutenberg block.
Will Tidy Related Posts slow down my site?
No. Similarity scores are pre-computed via WP-Cron batch processing and stored in the database. Results are cached using WordPress transients, so related posts are served instantly from cache on each page load. The plugin does not run any heavy queries on the front-end.
Does it support custom post types?
Yes. You can enable custom post types in the plugin settings. Any public post type that uses taxonomies can be included in the similarity calculation. Related posts will only show posts of the same type by default.
Can I exclude specific posts from related posts?
Yes. When editing a post, you can use the Tidy Related Posts meta box in the editor sidebar to exclude that post from appearing as a related post on other pages. You can also exclude entire categories from the settings page.
What is the internal link audit?
The internal link audit dashboard (found under Related Posts > Link Audit) scans your published content and identifies posts with few or no internal links pointing to them. This helps you discover linking opportunities, improve your site structure, and boost SEO by ensuring every post is well-connected within your site.
Can I override the templates in my theme?
Yes. Tidy Related Posts supports theme template overrides. Copy the plugin template files to a tidy-related-posts/ directory inside your active theme folder. The plugin will use your custom templates instead of the defaults, giving you full control over the HTML output.