Contextual Related Posts plugin for WordPress

Contextual Related Posts now has a new home at WebberZone. Check out the dedicated page and access support.


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.

Contextual Related Posts is one of the most feature rich related posts plugins for WordPress with support for thumbnails, shortcodes, widgets, custom post types, caching and CSS styles.

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 ] (no spaces) 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
    • 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
    • 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
  • 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



  1. Download Contextual Related Posts
  2. Extract the contents of to wp-content/plugins/ folder. You should get a folder called contextual-related-posts
  3. Activate the Plugin in WP-Admin
  4. Goto Settings > Related Posts to configure
  5. Optionally visit the Custom Styles tab to add any custom CSS styles. These are added to wp_head on the pages where the posts are displayed


Below are screenshots of the options available in the Settings screen

  1. CRP options in WP-Admin - General options

    CRP options in WP-Admin - General options

  2. CRP options in WP-Admin - List tuning options

    CRP options in WP-Admin - List tuning options

  3. CRP options in WP-Admin - Output options

    CRP options in WP-Admin - Output options

  4. CRP options in WP-Admin - Thumbnail options

    CRP options in WP-Admin - Thumbnail options

  5. CRP options in WP-Admin - Styles

    CRP options in WP-Admin - Styles

  6. CRP options in WP-Admin - Feed options

    CRP options in WP-Admin - Feed options

  7. Default style of Related Posts

    Default style of Related Posts

  8. Contextual Related Post metabox in the Edit Posts screen

    Contextual Related Post metabox in the Edit Posts screen

  9. CRP Widget

    CRP Widget

  10. Tools page

    Tools page

  11. Gutenberg block - Settings sidebar

    Gutenberg block - Settings sidebar

If you disable automatic display of related posts please add <?php if(function_exists('echo_ald_crp')) echo_ald_crp(); ?> to your template file where you want the related posts to be displayed.



Release post:

  • Features:

    • REST API support – you can now fetch the related posts via the REST API. Fetch posts at /contextual-related-posts/v1/posts/<id>
    • New setting in the metabox to exclude specific terms
  • Enhancements/modifications:

    • Thumbnail function uses the size instead of exact array of sizes to better select the appropriate thumbnail image size
    • Use site icon if no other thumbnail is found
    • Use both post_title and post_content fields for matching even when match content setting is off
    • Passing post_type and posts_per_page arguments will be respected instead of being overridden
  • Bug fixes:

    • Don’t enqueue wp-editor on widgets.php
    • WP_Query stopwords are stripped from content that is matched
    • Manual posts are added after the automatic posts are shuffled

Read previous entries in the changelog.

Writing and testing plugins takes a good amount of time. If you like the plugin and find it useful and would like to donate something for my work please do click the Paypal Donate button below. The payment is secure. I haven’t filled in any amount. Feel free to donate what you please. Any amount is welcome. Thank you 🙂


All files and their contents are licensed under the GNU General Public License (GPL).

Questions or Bugs

Please use the support forum if you have any questions or would like to report any bugs.


Download Contextual Related Posts
Last updated: November 28, 2021
Page on

(Visited 169,345 times, 1 visits today)