Plugin info

Total downloads: 71,895
Active installs: 4,000
Total reviews: 46
Average rating: 4.9
Support threads opened: 1
Support threads resolved: 1 (100%)
Available in: 6 language(s)
Contributors: 1
Last updated: 9/19/2025 (102 days ago)
Added to WordPress: 8/7/2015 (10 years old)
Minimum WordPress version: 3.5
Tested up to WordPress version: 6.8.3
Minimum PHP version: f

Maintenance & Compatibility

Maintenance score

Maintained • Last updated 102 days ago • Support resolved 100% • 46 reviews

66/100

Is Custom Related Posts abandoned?

Likely maintained (last update 102 days ago).

Compatibility

Requires WordPress: 3.5
Tested up to: 6.8.3
Requires PHP: f

Similar & Alternatives

Explore plugins with similar tags, and compare key metrics like downloads, ratings, updates, support, and WP/PHP compatibility.

No similar plugins found yet.

Description

Custom Related Posts is a user friendly plugin for manually adding related posts to any of your posts, pages or custom post types. You have full control over those related links, choosing for yourself if they go both ways.

An overview of the features:

  • Set which post types the plugin is active for yourself
  • Easily define relations in one or both ways on the post edit page
  • Display related posts with a shortcode, widget or block
  • Optionally show featured images in any size
  • Import from XML using post IDs
  • Compatible with the Classic Editor and Gutenberg Block Editor

Need help?
Check out our documentation!

This plugin is under active development. Any feature requests are welcome!

Installation

  1. Upload the custom-related-posts directory (directory included) to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Check out our getting started documentation

Frequently Asked Questions

Do you offer any support?

Yes! We pride ourselves on offering awesome support and almost always answer support questions within 24 hours. Send us an email at [email protected] whenever you have a question or suggestion!

Review feed

wbxpress
1/3/2023

Awesome

I am using it for more than few years. Its perfect.
alordiel
10/3/2023

Works perfectly

Simple and light, it is all I need for my project. The Gutenberg integration is pretty cool and UI is easy to work with. Thank you.
Lovro Hrust
10/21/2025

A fine plugin!

Plugin does its job and it is very usable to integrate in large projects. However, author should be caution to announce plugin HTML output change as breaking changes.

Screenshots

  1. The Custom Related Posts block and plugin sidebar

    The Custom Related Posts block and plugin sidebar

  2. Add relations by searching for posts

    Add relations by searching for posts

Changelog

1.8.0

  • Feature: Add customizable fields for related posts display including author, date, and excerpt
  • Feature: Implement search type selection in the related posts modal with customizable search options (by title, ID, or default)
  • Feature: Updated cached relation data through settings
  • Feature: Setting to change title HTML tag
  • Feature: Add setting to enable or disable self-reference links in related posts output
  • Improvement: Output optional alt and title tag for images
  • Improvement: Add optional class support for custom related posts block output
  • Improvement: Wrapper div container for title and list
  • Fix: Restrict access to API endpoints to logged in users only

1.7.5

  • Improvement: WordPress 6.8 compatibility
  • Fix: Sanitization to prevent misuse of shortcode by contributors
  • Fix: Loading translations too early

1.7.4

  • Fix: Restrict AJAX access to prevent misuse by contributors

1.7.3

  • Fix: Notice due to incorrect textdomain loading

1.7.2

  • Fix: Block editor error if related post is broken

1.7.1

  • Fix: Prevent deprecation warning

1.7.0

  • Feature: Manually set order for related posts (Block Editor only)
  • Feature: Setting to disable pinning of related posts images
  • Improvement: Image responsive sizing in some situations
  • Fix: Prevent PHP 8 deprecation notice related to usort

1.6.6

  • Fix: Block editor preview broken in WordPress 5.8

1.6.5

  • Fix: Problem when unpinning CRP sidebar in Gutenberg

1.6.4

  • Fix: Allow removing of relations to permanently deleted posts

1.6.3

  • Fix: Prevent PHP notice in WordPress 5.5

1.6.2

  • Feature: Limit by post type when searching for relations

1.6.1

  • Feature: Thumbnails in output are links as well
  • Improvement: Bring back shortcode button for TinyMCE
  • Fix: Class name error for list item title
  • Fix: PHP notice for missing variable

1.6.0

  • Feature: Show featured image for related posts
  • Feature: Setting to disable relation caching
  • Improvement: New settings page
  • Improvement: Filter hook for search arguments
  • Fix: Deleting related post to post type that has been disabled

1.5.1

  • Fix: Relations not loading correctly in Gutenberg

1.5.0

  • Feature: Gutenberg compatibility

1.4.1

  • Fix: PHP 7 Warning

1.4

  • Feature: Setting to open links in a new tab
  • Improvement: WordPress 4.8 compatibility
  • Improvement: $relation variable available in plugin hook

1.3

  • Improvement: Settings for searching related posts

1.2

  • Fix: Firefox compatibility problem

1.1

  • Feature: Import relations from XML

1.0

  • Very first version of this plugin