Custom Related Posts

Plugin Banner

Custom Related Posts

by Brecht

Download
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!

  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
  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

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 support@bootstrapped.ventures whenever you have a question or suggestion!

A fine plugin!

By Lovro Hrust (lovor) on October 21, 2025

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.

Simple, clear, does the job!

By septim on February 9, 2025

Quite a nice tool, allows to control what goes where with some useful layout options. Of course it's more work than automated plugins and as you add content you need to manually setup your links, but I'd rather have it this way.

Had a small issue with shrinking thumbnails on smaller screens for posts with long titles, but I could find the css code to add in the templates section in this very forum. Still I think this should be a default feature, or at least a checkbox option, because it looks weird when it happens.

Thanks for this light, simple & useful tool!

Everything I needed

By unklee on March 13, 2024

I have used this plugin for more than 3 years now and I am very pleased with it. I don't want a plugin that chooses compatible posts itself, thus slowing my page down. Rather I want one where I can do the choosing and the plugin puts it on the page with minimum fuss. Which is exactly what this plugin does. What's more, when I had a minor layout issue, and ask for support, I got a quick answer that resolved the issue. So thanks for a useful plugin that simply works.

Works perfectly

By alordiel on October 3, 2023

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.

Really nice plugin

By ririro on September 19, 2023

Simple and flexible. Really appreciate it.

Customize as you want

By jeffz8 on June 1, 2023

I want to control the links as needed. This plugin provides that functionality with a simple implementation.

It is a bit basic in appearance, but with a bit of CSS work, you can make it look as you want quite easily.

Good

By Helison Santos (agenciahouse) on March 20, 2023

It is a good plugin, simple and objective, but, the HTML is not encapsulated, the title is out of markup, this made my formatting a bit more complex.

Cool plugin!

By Yaroslav (ingyaroslav) on January 8, 2023

Thank you for plugin and documentation!

P.S. but add wrapper div 😉
div.crp-list-wrapper
- h3.crp-list-title
- div.crp-list

Awesome

By wbxpress on January 3, 2023

I am using it for more than few years. Its perfect.

Great plugin, great support

By fdphonk on September 14, 2022

The plugin is easy to manage and works perfectly. When I had a minor problem, their e-mail support responded within minutes and was able to help me out immediately. Highly recommended.

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
Back to top