Related Posts by Taxonomy


Quickly increase your readers’ engagement by adding related posts in the sidebar or after post content with a widget or shortcode.

Posts with the most terms in common will display at the top!

This plugin is capable of finding related posts in multiple taxonomies and post types. Include or exclude terms from the search for related posts. Change the look and feel by using your own templates in your (child) theme.

plugin documentation

Plugin features:

  • Widget and Shortcode.
  • Display related posts as post thumbnails, links, excerpts or full posts.
  • Small Footprint. Doesn’t slow down your site!
  • Automatic display of related posts after the post content.
  • Search for related posts in single or multiple taxonomies and post types.
  • Exclude or include terms and posts.
  • Limit the search of related posts by date or number.
  • Use your own HTML templates for display of the related posts.
  • Use the WordPress REST API to get related posts. (opt-in feature)
  • Use a persistent cache layer for the related posts. (opt-in feature)
  • Use plugin functions in your theme templates to display related posts yourself.
  • Use Filters to change the default behavior of the plugin.
  • Extensive plugin documentation.
  • Highly Adjustable!
  • Follows WordPress coding standards and plugin best practices.

Follow this plugin on GitHub.

See the FAQ to have related posts automatically display after the post content without using the shortcode or widget.

Default usage for the shortcode is:


Attributes for the shortcode are:

  • post_id
  • taxonomies
  • post_types
  • posts_per_page
  • order
  • orderby
  • before_shortcode
  • after_shortcode
  • title
  • show_date
  • before_title
  • after_title
  • terms
  • include_terms
  • exclude_terms
  • exclude_posts
  • format
  • image_size
  • columns
  • caption
  • link_caption
  • limit_posts
  • limit_year
  • limit_month
  • related
  • public_only
  • include_self
  • post_class

Example to show 10 related posts instead of the default 5.

[related_posts_by_tax posts_per_page="10"]

See the documentation for more information about these attributes.


Captures d’écran

  • The Widget
  • Twenty Fifteen screenshot. Related posts in the sidebar and after post content
  • Twenty Twelve screenshot. Post thumbnails (after post content) and the widget
  • Twenty Thirteen screenshot. Post thumbnails (after post content) and the widget


  • Unzip the folder.
  • Upload the related-posts-by-taxonomy folder to your /wp-content/plugins directory.
  • Activate Related Posts by Taxonomy.
  • That’s it, now you are ready to use the widget and shortcode


For more information about the plugin see the plugin documentation.
To customize this plugin see the plugin recipes page.

Can I change the layout for the related posts?

Yes. Review this section of the documentation to style the related posts yourself.

How can I automatically add related posts after the post content?

Review Adding Related Posts After the Post Content.

Can I include or exclude posts or terms with the widget or shortcode

Yes. For the widget see this filter and for the shortcode see the attributes terms, include_terms, exclude-terms and exclude_posts.

Can I set my own defaults for the shortcode?

Yes. Review Setting your own defaults for the shortcode

The widget only lets you choose « all taxonomies » or a single taxonomy. Can I make it use multiple specific taxonomies?

Yes. See this filter on how to do that.

Is this plugin GDPR compliant?
  • This plugin doesn’t process, share, send or retain any user data.
  • This plugin doesn’t track (user) data for analytics (or for any other reason).
  • This plugin doesn’t save or read cookies.
  • This plugin doesn’t use 3rd party libraries.

Read this article why plugin authors cannot guarantee 100% compliance.

Please contact a GDPR consultant or law firm with this information to assess if this plugin is compliant.


Fantastically coded and well supported

On my bespoke site, I wanted to sort out ‘related’ posts for a specific post type.
I was dreading the mess of comparing taxonomies and even considering which ones I should ‘weigh’ more than others. Plus I wanted to factor in some other fun mathematical aspects based on previously calculated values.

I’d (cleverly, I thought) done the up front work of multiple custom taxonomies, where related posts could be found. And yes, I had the use of a faceted filtering engine to help people find things. But I wanted more. I wanted to be able to say « Did you like this show? Here are some more! »

My goal was to get the code done pre WCUS, and I had just started to break out the work into manageable chunks over US thanksgiving, with the code beginning to take shape, when I thought « Surely someone has done this… »

At first, all I found were plugins that did one job or another. One related your defined meta values, one let you manually chose, and so on. Then I found this one and struck the motherlode. Gold, I tell you, pure gold!

Sure while it looked like just ‘another’ related taxonomy plugin. Then I read the documentation and was rhapsodic! @keesiemeijer put in the work to make it filterable and hookable! I could take that expert work and add on to it, using the basic related posts by taxonomies and add in my weird meta values.

When I stumbled, I asked for help and found it with a brand new filter made just for insane people like me.

Out of the box, this plugin works amazingly well. Fast, lightweight, and efficient. Add in those filters? It’s the best thing since Betty White.

The best plugin and the best support

I love that the plugin configuration is not done from the back office, but from a shortcode that I can configure and put anywhere, configuring the shortcode parameters.
On the other hand highlight the support, in a day two doubts solved with a lot of efficiency.
Thank you!!!

Perfectly Perfect

Yes, it works. I add the shortcode to my ad plugin for placement after the last paragraph and Bam! Works amazingly well. And yes, the posts are related with the most related at the top of the list.

Excellent plugin

This is the related posts plugin I’ve been looking for. Powerful, flexible, extremely customizable thanks to plenty of parameters to set up. I use it in association with an ad insertion plugin to manage the position. Excellent job.

Lire les 63 avis

Contributeurs & développeurs

« Related Posts by Taxonomy » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.


“Related Posts by Taxonomy” a été traduit dans 5 locales. Remerciez l’équipe de traduction pour ses contributions.

Traduisez « Related Posts by Taxonomy » dans votre langue.

Le développement vous intéresse ?

Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.



  • Enhancement
    • Add ability to show the post date after the post title
    • Allow getting post fields from the cache
    • Add new filter to filter all related post permalinks
    • Add new tests for the post type feature (GitHub)
  • Bug fixes
    • (minor) Add post classes after retrieving posts from the cache
    • (minor) Return an error if invalid taxonomies or post types was requested with the WP Rest API


  • Enhancement
    • Prepare plugin for gutenberg blocks
    • Add ‘terms’ parameter for shortcode and widget
    • Add GDPR information to readme.txt
    • deprecate functions (with back compatibility)
      • km_rpbt_related_posts_by_taxonomy()
      • km_rpbt_get_default_args()
      • km_rpbt_related_posts_by_taxonomy_validate_ids()
      • km_rpbt_related_posts_by_taxonomy_template()
      • km_rpbt_post_title_link()
      • km_rpbt_get_related_post_title_link()
      • km_rpbt_related_posts_by_taxonomy_widget()
  • Bug fixes
    • (minor) Add missing filter pre_related_posts before cache queries
    • (minor) Add missing properties to related posts returned by the cache


  • Enhancement
    • Add post classes with filters or as a shortcode or widget argument
    • Move included current post to the top of the stack by default


  • Enhancement
    • Add public_only parameter to not display private related posts from the current author.
    • Add include_self parameter to include the current post in the related posts.
    • Add filter pre_related_posts to override the related posts query.
  • Bug fixes
    • Fix duplicate gallery IDs breaking the column layout of WordPress galleries. Props: @sonamel


  • Enhancement
    • Add support to disable the shortcode or widget for this plugin
    • Add support to update all plugin settings with one filter.

For older changelog versions see the changelog.txt file