Related Posts by Categories and Tags


This is the penultimate version of Related Posts by Categories and Tags. Contextual Related Posts v3.0.0 will incorporate all the functionality of this plugin.

Related Posts by Categories and Tags is an extension for Contextual Related Posts that adds another degree of related posts matching by adding the option to restrict these related posts to the same category, tag or custom taxonomy.

Additionally, you can also disable the contextual matching engine either on posts/pages or on only custom post types.

Requires Contextual Related Posts v2.6.0 or higher.


Related Posts by Categories and Tags is open for contribution 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.


  • New options in WP-Admin - General options
  • New options in WP-Admin - List Tuning options
  • New options in WP-Admin - Output options


WordPress install (the easy way)

  1. Navigate to Plugins within your WordPress Admin Area

  2. Click “Add new” and in the search box enter “Related Posts by Categories and Tags”

  3. Find the plugin in the list (usually the first result) and click “Install Now”

Manual install

  1. Download the plugin

  2. Extract the contents of to wp-content/plugins/ folder. You should get a folder called crp-taxonomy.

  3. Activate the Plugin in WP-Admin.

  4. Goto Settings » Related Posts to configure. You’ll find two checkboxes under General Options


If your question isn’t listed here, please create a new post detailing your problem in the support forum. It is the fastest way to get support as I monitor the forums regularly. I also provide premium paid support via email.


27 Մարտի, 2021
After install and activate this plugin on WP 5.7: There was a critical error on your website.
5 Հոկտեմբերի, 2020
Plugin could not be activated because it triggered a fatal error. Fatal error: Uncaught Error: Call to undefined function crp_read_options() in.... /wp-admin/plugins.php(193): do_action('activate_crp-ta...') #5 {main} thrown in /home4/vinewoo1/public_html/quizcrayolex/wp-content/plugins/crp-taxonomy/includes/activation.php on line 60
2 Սեպտեմբերի, 2018
The plugin is really good and doing perfect work.
28 Հուլիսի, 2017
I'm REALLY happy with Contextual Related Posts, not least because it's well structured and easy to customise. But we have several authors, all with different writing styles, so the content search wasn't always finding the best results. Found this taxonomy plugin - and was a bit worried that it would stop looking for related content as well as tags. Results are excellent, though. Thank you 🙂
Read all 10 reviews

Contributors & Developers

“Related Posts by Categories and Tags” is open source software. The following people have contributed to this plugin.




Release post:

This is the penultimate version and is compatible with Contextual Related Posts v2.9.3 and below. All its functonality will be included in Contextual Related Posts v3.0.0.

Some settings have been renamed in preparation for the new version.

  • Enhancements:

    • Exclude on categories uses the short circuit filter introduced in Contextual Related Posts v2.9.0
    • Use $args instead of global $crp_settings for all filters
  • Bug fixes:

    • Use crp_get_settings instead of crp_read_options


Release post:

  • Features:

    • New option to enter the minimum number of common taxonomies to be matched before a post is considered related
    • New option to exclude display on select post categories. Does not work with tags or custom taxonomies
  • Bug fixes:

    • Resetting Contextual Related Posts settings with this plugin activated caused an error


Release post:

  • Bug fixes:
    • Saving settings added admin notices incorrectly
    • Delete settings on uninstall


Release post:

Plugin has been renamed to “Related Posts by Categories and Tags”

  • Enhancements:

    • Upgrade the plugin for the new Settings API in Contextual Related Posts v2.6.0
    • Add a notice in the admin page if Contextual Related Posts v2.6.0 and above is not installed
  • Deprecated:

    • Old settings interface — crpt_crp_default_options, crpt_save_options, crt_general_options, crt_tuning_options


  • Enhancements:

    • When “Match all taxonomy terms” is selected, only taxonomies for the current post type is selected. This reduces the cases where no posts are found. Posts are also now properly ranked by relevancy
  • Bug fixes:

    • Fixed PHP notices


  • Features:

    • Option to match by all taxonomies — Contributed by Enchiridion
  • Bug fixes:

    • Filters not working when only taxonomies are being used — Contributed by Enchiridion
    • Activation of the plugin failed with Contextual Related Posts v2.2.x


  • Features:
    • Added support for custom taxonomies. Very useful if your custom post types have custom taxonomies
    • Disable contextual matching


  • Initial release