Plugin Directory

Contextual Related Posts

Display related posts on your WordPress blog and feed. Supports thumbnails, shortcodes, widgets and custom post types!

Contextual Related Posts is a powerful plugin for WordPress that allows you to display a list of related posts on your website and in your feed.

The list is based on the content of the title and/or content of the posts which makes them more relevant and more likely to be of interest to your readers. This allows you to retain visitors, reduce bounce rates and refresh old entries.

Although several similar plugins exist today, Contextual Related Posts is one of the most feature rich plugins with support for thumbnails, shortcodes, widgets, custom post types and CSS styles. The inbuilt cache ensures that you have related posts without excessive load on your server.

And the default inbuilt styles allow you to switch between gorgeous thumbnail-rich related posts or a similar text display!

Key features

  • Automatic: CRP will start displaying related posts on your site and feed automatically after the content when you activate the plugin. No need to edit template files
  • Manual install: Want more control over placement? Check the FAQ on which functions are available for manual install.
  • Widgets: Add related posts to widgetized area of your theme. Lots of options available
  • Shortcode: Use [crp] to display the posts anywhere you want in the post content
  • The algorithm: Find related posts by title and/or content of the current post
  • Caching: Related posts output is automatically cached as visitors browse through your site
  • Exclusions: Exclude posts from categories from being displayed in the list. Or you can exclude posts or pages by ID
  • Custom post types: The related posts list lets you include posts, pages, attachments or any other custom post type!
  • Thumbnail support:
    • Support for WordPress post thumbnails. CRP will create a custom image size (crp_thumbnail) with the dimensions specified in the Settings page
    • Auto-extract the first image in your post to be displayed as a thumbnail
    • Manually enter the URL of the thumbnail via WordPress meta fields. Specify this using the meta box in your Edit screens.
    • Optionally, use timthumb to resize images or use your own filter function to resize post images
  • Styles: The output is wrapped in CSS classes which allows you to easily style the list. You can enter your custom CSS styles from within WordPress Admin area or use the style included.
  • Customisable output:
    • Display excerpts in post. You can select the length of the excerpt in words
    • Customise which HTML tags to use for displaying the output in case you don't prefer the default list format
  • Extendable code: CRP has tonnes of filters and actions that allow any developer to easily add features, edit outputs, etc.



I spend a significant amount of my free time maintaining, updating and more importantly supporting this plugin. Those who have sought support in the support forums know that I have done my best to answer your question and solve your problem. If you have been using this plugin and find this useful, do consider making a donation. This helps me pay for my hosting and domains.


Contextual Related Posts is also available on Github. So, if you've got some cool feature that you'd like to implement into the plugin or a bug you've been able to fix, consider forking the project and sending me a pull request.

Bug reports are welcomed on GitHub. Please note GitHub is not a support forum and issues that aren't properly qualified as bugs will be closed.


Contextual Related Posts is now on Transifex with several translations made available by the WP Translations. If you're a translator, do consider joining the WP Translations team and contribute towards this and a huge number of WordPress plugins.

Visit Contextual Related Posts on Transifex.

Requires: 3.5 or higher
Compatible up to: 4.4
Last Updated: 2 months ago
Active Installs: 60,000+


4.8 out of 5 stars


15 of 36 support threads in the last two months have been resolved.

Got something to say? Need help?


Not enough data

3 people say it works.
0 people say it's broken.

100,1,1 100,1,1
100,1,1 100,2,2
100,2,2 100,1,1 100,3,3 100,1,1
100,1,1 50,2,1 50,2,1
100,5,5 100,1,1 100,3,3 100,2,2 50,6,3 0,1,0 0,1,0 0,1,0
75,4,3 100,2,2 100,5,5 50,2,1 100,2,2 100,2,2
100,1,1 100,3,3
100,1,1 100,11,11 100,1,1
75,4,3 100,1,1
100,1,1 100,2,2 75,4,3
50,2,1 100,2,2 100,1,1 100,3,3
100,2,2 100,1,1 100,2,2
100,1,1 100,1,1
100,1,1 100,1,1 100,2,2 100,1,1
100,2,2 100,1,1 100,1,1
100,2,2 100,1,1
100,1,1 100,2,2
100,1,1 100,3,3