Title: Custom Related Posts Author: Brecht Published: August 7, 2015 Last modified: January 23, 2026 --- Search plugins ![](https://ps.w.org/custom-related-posts/assets/banner-772x250.png?rev=2014118) ![](https://ps.w.org/custom-related-posts/assets/icon-256x256.png?rev=2007814) # Custom Related Posts By [Brecht](https://profiles.wordpress.org/brechtvds/) [Download](https://downloads.wordpress.org/plugin/custom-related-posts.1.8.1.zip) * [Details](https://en-ca.wordpress.org/plugins/custom-related-posts/#description) * [Reviews](https://en-ca.wordpress.org/plugins/custom-related-posts/#reviews) * [Installation](https://en-ca.wordpress.org/plugins/custom-related-posts/#installation) * [Development](https://en-ca.wordpress.org/plugins/custom-related-posts/#developers) [Support](https://wordpress.org/support/plugin/custom-related-posts/) ## 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](https://help.bootstrapped.ventures/collection/155-custom-related-posts)! This plugin is under active development. Any feature requests are welcome! ## Screenshots * [[ * The Custom Related Posts block and plugin sidebar * [[ * Add relations by searching for posts ## Blocks This plugin provides 1 block. * Custom Related Posts ## 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](https://help.bootstrapped.ventures/category/159-getting-started) ## FAQ ### 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](https://en-ca.wordpress.org/plugins/custom-related-posts/support@bootstrapped.ventures?output_format=md) whenever you have a question or suggestion! ### Where do I report security bugs found in this plugin? Please report security bugs found in the source code of the undefined plugin through the [Patchstack Vulnerability Disclosure  Program](https://patchstack.com/database/vdp/9e5fc6c6-185c-40ee-9658-ac57163cfdec). The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin. ## Reviews ![](https://secure.gravatar.com/avatar/ca481b56965d51c2202d6b74d3e6567908a142d529dc39061546a1acef255af2? s=60&d=retro&r=g) ### 󠀁[A fine plugin!](https://wordpress.org/support/topic/a-fine-plugin-6/)󠁿 [Lovro Hrust](https://profiles.wordpress.org/lovor/) 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. ![](https://secure.gravatar.com/avatar/a52635389a121acb515a6113cf03cbc9a215023a3931d729e5a50b65fc0a7123? s=60&d=retro&r=g) ### 󠀁[Simple, clear, does the job!](https://wordpress.org/support/topic/simple-clear-does-the-job/)󠁿 [septim](https://profiles.wordpress.org/septim/) 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! ![](https://secure.gravatar.com/avatar/62ecccef188ea90ddd93c19d700736e231d6f5bc6eaa961a81b8112a5f048517? s=60&d=retro&r=g) ### 󠀁[Everything I needed](https://wordpress.org/support/topic/everything-i-needed-29/)󠁿 [unklee](https://profiles.wordpress.org/unklee/) 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. ![](https://secure.gravatar.com/avatar/3e9057ccb320023cf1de85e31a23c214e2b16744c4a5fc33894974a5a5955b03? s=60&d=retro&r=g) ### 󠀁[Works perfectly](https://wordpress.org/support/topic/works-perfectly-2691/)󠁿 [alordiel](https://profiles.wordpress.org/alordiel/) 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. ![](https://secure.gravatar.com/avatar/4f9d79f66a94f0dbc28bf8ecad6c5fc37948e1df4f502163d895322a0796db33? s=60&d=retro&r=g) ### 󠀁[Really nice plugin](https://wordpress.org/support/topic/really-nice-plugin-162/)󠁿 [ririro](https://profiles.wordpress.org/ririro/) September 19, 2023 Simple and flexible. Really appreciate it. ![](https://secure.gravatar.com/avatar/b8bc6363810a5a5feb0adcf192462bb44322737176a39625cea672e3ca544f86? s=60&d=retro&r=g) ### 󠀁[Customize as you want](https://wordpress.org/support/topic/customize-as-you-want/)󠁿 [jeffz8](https://profiles.wordpress.org/jeffz8/) 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. [ Read all 46 reviews ](https://wordpress.org/support/plugin/custom-related-posts/reviews/) ## Contributors & Developers “Custom Related Posts” is open source software. The following people have contributed to this plugin. Contributors * [ Brecht ](https://profiles.wordpress.org/brechtvds/) “Custom Related Posts” has been translated into 5 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/custom-related-posts/contributors) for their contributions. [Translate “Custom Related Posts” into your language.](https://translate.wordpress.org/projects/wp-plugins/custom-related-posts) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/custom-related-posts/), check out the [SVN repository](https://plugins.svn.wordpress.org/custom-related-posts/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/custom-related-posts/) by [RSS](https://plugins.trac.wordpress.org/log/custom-related-posts/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.8.1 * Improvement: Compatibility with Block Editor in iFrame * Fix: Additional check to make sure a logged in user can only see his own posts * Fix: Change default post status to published only * Fix: Icon color in Block Editor #### 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 ## Meta * Version **1.8.1** * Last updated: **3 months ago** * Active installations: **3,000+** * WordPress Version: ** 3.5 or higher ** * Tested up to: **6.9.4** * Language: * [Dutch](https://nl.wordpress.org/plugins/custom-related-posts/), [English (US)](https://wordpress.org/plugins/custom-related-posts/), [Russian](https://ru.wordpress.org/plugins/custom-related-posts/), [Spanish (Chile)](https://cl.wordpress.org/plugins/custom-related-posts/), [Spanish (Spain)](https://es.wordpress.org/plugins/custom-related-posts/), and [Swedish](https://sv.wordpress.org/plugins/custom-related-posts/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/custom-related-posts) * Tags: * [custom post type](https://en-ca.wordpress.org/plugins/tags/custom-post-type/) [related posts](https://en-ca.wordpress.org/plugins/tags/related-posts/)[widget](https://en-ca.wordpress.org/plugins/tags/widget/) * [Advanced View](https://en-ca.wordpress.org/plugins/custom-related-posts/advanced/) ## Ratings 4.9 out of 5 stars. * [ 42 5-star reviews ](https://wordpress.org/support/plugin/custom-related-posts/reviews/?filter=5) * [ 3 4-star reviews ](https://wordpress.org/support/plugin/custom-related-posts/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/custom-related-posts/reviews/?filter=3) * [ 1 2-star review ](https://wordpress.org/support/plugin/custom-related-posts/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/custom-related-posts/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/custom-related-posts/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/custom-related-posts/reviews/) ## Contributors * [ Brecht ](https://profiles.wordpress.org/brechtvds/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/custom-related-posts/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QG7KZMGFU325Y)