Plugin Directory

Test out the new Plugin Directory and let us know what you think.

Contextual Related Posts

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


  • Bug fixes:
    • Replaced .crp_title wrapper from div to span. Empty the cache via the settings page and also your browser cache


  • Features:

    • Shortcode and the widget now have an added parameter for 'offset'. This is useful if you would like to display different widgets/shortcodes but not always start from the first post
    • New option in metabox: "Exclude this post from the related posts list"
    • New option: Insert after nth paragraph
  • Enhancements:

    • The generated HTML code uses a single a href tag rather than two separate ones per item which is usually better for SEO. If you're not using the Rounded Thumbnail style and using your own custom style, then you might need to reconfigure this
    • New constant CRP_MAX_WORDS (default 500) limits the post content to be compared. Add this to your wp-config.php file to overwrite
  • Bug fixes:

    • Language files initialisation had the wrong text domain
    • Stop updating the thumb settings if the existing value isn't found. Caused incorrect changes in certain installations
    • Force link text to white when using Rounded Thumb style
    • The plugin will no longer generate any notices if post author is missing
  • Deprecated:

    • Removed wick for exclude categories auto-suggest. Plugin now uses jQuery Suggest that is included in WordPress. When you re-save plugin options, the field will convert the slugs to the category name
    • Deprecated $crp_url. Use the new constants CRP_PLUGIN_DIR, CRP_PLUGIN_URL and CRP_PLUGIN_FILE


  • Enhancements:

    • Changed text domain to contextual-related-posts in advance of translate.wordpress.org translation system
    • Improved support for WPML. If available, same language posts will be pulled by default. To restrict to the same language add this code to your theme's functions.php file
    • Removed id tag from related posts HTML output to make it W3C compliant. If you're using the id with your custom styles, please change this to classes i.e. change #crp_related to .crp_related and it should work
  • Bug fixes:

    • All cache entries were not deleted on uninstall


  • Features:

    • Preliminary support for WPML
  • Enhancements:

    • Recreate Index and Activation will not try to alter the table engine if not needed
  • Bug fixes:

    • All thumbnail classes were not properly applied + new thumbnail class filter
    • Shortcode with "exclude_categories" argument works again


  • Bug fixes:
    • "No styles" would not get selected if "Rounded thumbnails' was enabled
    • "Recreate Index" caused a fatal error: Call to undefined function crp_single_activate()
    • Excerpt shortening was not working correctly
    • Exclude categories wasn't working in some cases
    • Additional check to see if default styles are off, then force No style


  • Features:

    • Manual posts can now be set in the meta box in the Edit Post screens which will be displayed before the related posts fetched by the plugin
    • Choose between No style, Rounded thumbnails (previously called default style) and Text only style options under the Styles box in the plugin settings page
    • Option to turn off the Contextual Related metabox on Edit Posts screens or limit it to Admins only. Also applies to Pages and Custom Post Types
    • Filter crp_link_attributes that allows a user to add or remove attributes for the a tag
    • Notice is displayed at the top of the Settings page if there are any missing of the FULLTEXT indices missing
    • Option in the Contextual Related Posts meta box to disable the related posts on the selected post
    • Select post type in the Related Posts Widget
  • Enhancements:

    • Optimised number of queries for exclude categories option. Those not using this option will see the greatest savings
    • Select a pre-built thumbnail size will automatically update the width, height and crop settings. The default style will no longer enforce the 150x150 thumbnail size.
    • strict_limit argument in get_crp_posts_id is now TRUE by default
    • get_crp takes an additional argument: heading (default is TRUE) that controls the display of the main heading (Related Posts)
    • Output of echo_crp will be cached in a separate meta key
  • Bug fixes:

    • First child now gets the correct thumbnail size
  • Deprecated:

    • ald_crp() - Use get_crp() instead
    • ald_crp_content() - Use crp_content_filter() instead
    • ald_crp_rss() - Use crp_rss_filter() instead
    • echo_ald_crp() - Use echo_crp() instead


  • Enhancements:
    • Settings page now clearly highlights what options cannot be changed if the default styles are enabled, i.e. thumbnail settings and no excerpt, author or date


  • Features:

    • Separate cache for related posts added to feeds. Prevents conflict with the cache for normal related posts
    • Timthumb has been deprecated
    • Setting "Related posts should be newer than:" to 0 to disable limiting posts by age
    • Filters crp_posts_match, crp_posts_now_date, crp_posts_from_date to modify the WHERE clause
  • Enhancements:

    • thumb_timthumb, thumb_timthumb_q and filter attributes for the function crp_get_the_post_thumbnail have been deprecated. If you're using this function, an entry will be created for the deprecated log
    • Reset default thumbnail URL location to plugin default if the field is blank or only contains /default.png
    • Meta-box will no longer be displayed on non-public post types
    • For first image, the plugin will attempt to seek the correct thumbnail size if available
  • Bug fixes:

    • Author link was incorrectly displayed multiple times in the list when Show Author was enabled
    • WP Notice Errors when using the Widget via the Customizer menu in WordPress
    • Incorrect thumbnail was pulled on attachment pages


  • Bug fixes:
    • Clear Cache button which broke in 2.0.0


  • Features:

    • Multi-site support. Now you can Network Activate the plugin and all users will see related posts!
    • Thumbnails are registered as an image size in WordPress. This means WordPress will create a copy of the image with the specified dimensions when a new image is uploaded. For your existing images, I recommend using Force Regenerate Thumbnails
    • Completely filterable mySQL query to fetch the posts. You can write your own functions to filter the fields, orderby, groupby, join and limits clauses
  • Enhancements:

    • Lookup priority for thumbnails. The thumbnail URL set in the Contextual Related Posts meta box is given first priority
    • Removed border=0 attribute from img tag for HTML5 validation support
    • Default option for timthumb is disabled
    • Default option for post types to include is post and page
    • get_crp_posts has been deprecated. See get_crp_posts_id instead
    • Turning on the Default style will switch on thumbnails, correctly resize them and will also hide authors, excerpts and the post date
  • Bug fixes:

    • Post image will now be loaded over https if the visitor visits your site on https

Earlier versions

For the changelog of earlier versions, please refer to the separate changelog.txt file.

Requires: 4.1 or higher
Compatible up to: 4.7.1
Last Updated: 1 month ago
Active Installs: 60,000+


4.8 out of 5 stars


8 of 21 support threads in the last two months have been marked resolved.

Got something to say? Need help?


Not enough data

0 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