Beginner's Guide for WordPress - Start your WordPress Blog in minutes.
Choosing the Best
WordPress Hosting
How to Easily
Install WordPress
WordPress Plugins
View all Guides

How to Display Related Posts in WordPress

Last updated on by
Special WordPress Hosting offer for WPBeginner Readers
How to Display Related Posts in WordPress

If you know anything about bounce rate, you are probably already showing related posts in WordPress. Bounce rate essentially represents the percentage of initial visitors to a site who “bounce” away to a different site, rather than continue on to other pages within the same site. This can have a significant impact on your adsense earning. By adding Related posts in WordPress you are killing three birds with one stone. You are decreasing your bounce rate, you are increasing your adsense income, and lastly you are increasing your pageviews. In this article we will show you how you can display related posts in WordPress with and without a plugin.

There are two methods of doing so and you can choose whichever method you prefer. One way is doing it without a plugin and then there is another method that is doing it with a plugin.

Display Related Posts in WordPress without a Plugin

Paste the following code in single.php where you want to display related posts

//for use in the loop, list 5 post titles related to first tag on current post
$tags = wp_get_post_tags($post->ID);
if ($tags) {
echo 'Related Posts';
$first_tag = $tags[0]->term_id;
'tag__in' => array($first_tag),
'post__not_in' => array($post->ID),
$my_query = new WP_Query($args);
if( $my_query->have_posts() ) {
while ($my_query->have_posts()) : $my_query->the_post(); ?>
<a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title_attribute(); ?>"><?php the_title(); ?></a>


Source: MichaelH

Display Related Posts in WordPress with a Plugin

The plugin we use is called Yet Another Related Post Plugin (YARP). It gives you a list of posts and/or pages related to the current entry, introducing the reader to other relevant content on your site. Key features include:

  • An advanced and versatile algorithm: Using a customizable algorithm considering post titles, content, tags, and categories, YARPP calculates a “match score” for each pair of posts on your blog. You choose the threshold limit for relevance and you get more related posts if there are more related posts and less if there are less.
  • Templating: New in 3.0! A new templating system puts you in charge of how your posts are displayed.
  • Caching: New in 3.0! YARPP now caches the related posts for all the posts and thus has significantly improved performance over versions 2.x.
  • Related posts in RSS feeds: Display related posts in your RSS and Atom feeds with custom display options.
  • Disallowing certain tags or categories: You can choose certain tags or categories as disallowed, meaning any page or post with such tags or categories will not be served up by the plugin.
  • Related posts and pages: Puts you in control of pulling up related posts, pages, or both.

Download YARP

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi. Page maintained by Syed Balkhi.

WPBeginner's Video Icon
Our HD-Quality tutorial videos for WordPress Beginners will teach you how to use WordPress to create and manage your own website in about an hour. Get started now »


  1. Mike G says:

    What plugin allows to display related post/pages on pages by “manually” selecting the pages that are related? Thank you

  2. Mike says:

    Hi, thanks for your awesome website!

    I have a question and would be grateful if your answer it; I have problem with both ways in this post regarding displaying relatedpost in my blog, if I add the related posts to the end of each post manually, then is that ok in terms of seo (or anything else)?

    Kind regards,

  3. Sumit Kumar Gogawat says:

    Great Post!

    I want to know how to add Related post right after first paragraph or middle in post in wordpress. can you please update me.

  4. Kyler Boudreau says:

    Thanks for this info! Exactly what I needed.

  5. JMunce says:

    I don’t get ‘related posts’ from this code.

    I just get recent posts

  6. Debb says:

    How about second tag? Can i change $first_tag to $second_tag?

  7. Ben Chung says:

    Thanks for the great tip.
    One thing I noticed is that I got an error when running it:
    “WP_Query was called with an argument that is deprecated since version 3.1! “caller_get_posts” is deprecated. Use “ignore_sticky_posts” instead. ”

    So replacing:

    ‘caller_get_posts’ => 1


    ‘caller_get_posts’ => 1

    fixed the problem.

  8. David says:

    This is great. Please direct me to how I can add a post image and date. Thanks!

  9. Sam says:

    Appreciate the tutorial! Very simple to implement.

    One question, does this only match articles by matching their first tag?


  10. Allie says:

    I am also using Genesis and there is not single.php form. Where do I input this? Thanks!

    • Chris Arter says:

      This code can be put in your functions file depending on what location of the page you’d like. for instance..


      if (is_singluar(‘post’)) {

      // your related posts code here


      The best place to put this is in your own plugin. Try not to edit your Functions file..

  11. Jornes says:

    Hi! I did apply this code to my website sidebar. But, i am wondering why it doesn’t work after i have implemented a php code that calls this function to work when the page is single.php. Do you know what is going wrong?

  12. Dave Noel says:

    You can insert ads at runtime using jquery. That’s what I do.

  13. Clay Teller says:

    Thanks for this useful bit of code! I think ordering the results randomly can be helpful for some sites to keep the related posts “fresh”. Can be done by adding ‘orderby’=>’rand’ argument like so:

    ‘tag__in’ => array($first_tag),
    ‘post__not_in’ => array($post->ID),

  14. Szyam says:

    Very nice! Looks like ‘caller_get_posts’ Now needs to be ‘ignore_sticky_posts’ instead. Works great.

  15. Russ Edwards says:

    Works great, but how would I split the results. I want to put an ad in between, so it would be, for example, 5 related posts -then ad- next five related posts, etc. i know there should be an “offset” somewhere in the second query, just not sure how or where it insert. help?

  16. Tom Nguyen says:

    Thanks for posting both ways of doing this. I prefer not to use another plugin. I’m going to try on my website since I have more than 20 blog posts.

  17. Sid says:

    I’m using Genesis and you know, there’s no separate single.php file. So, where should I paste this? In functions file? Also, is there something to edit at stylesheet?

  18. Danny says:

    Whoop! Whoop! Thanks so much for this code, I have been search for about a week, and this works just great once you style it.

    Thanks alot!

  19. Eline says:

    I don’t know how this work, and on linkwithin it doesn’t work, my blog isn’t slef-hosted! Help:(

  20. Rodrigo Ghedin says:

    I’m using and enjoying the manual solution. But I miss a conditional trigger for situations when there aren’t related posts. Right now it returns nothing. How could I fill that space with a “there’s no related posts” when… well, when there’s no related posts?


  21. Nadine says:

    I’m trying to change ‘showposts’ to 12 but it only shows up 2 items. Any ideas why? :/

    • Editorial Staff says:

      Just updated the article Nadine. showposts parameter have been depracated with posts_per_page.

  22. Vincentb says:

    Can you please add some more detail to your explanation? What do you mean by ‘tag version”? What file do I add the code above to (page.php?) and what do I change in that code to make it do what I described above?


    Serg, your plugin only works on Posts, is there a way to make it work on Pages too?

  23. sara says:

    I’m looking for something similar to this but based on categories. I would like to only display related articles from the current category.

    I have searched for a solution but can’t seem to find anything, any idea’s?


  24. will says:

    very use full thanks installed the YARP plugin and it works better than i thought it would thanks.

  25. Abhijit V. Chaore says:

    Sounds quite useful. Thanks for the information.

  26. Paisakamana says:

    Really great piece of code you got there.
    Great article I used this on my site and I like.

  27. brynh says:

    Very good article! It helped me much! Thank you.. I installed YARP and it works great..

  28. Chris Roane says:

    Thanks for providing the code. I needed something that was similar to this, but that took into account all of the tags for a post to generate the related posts.

    So I modified the code and posted it on my website. I did put a link to this page in the article. Here is the article that I wrote:

    • Taylor says:

      Thank you for linking to this! I was looking for a way to show related posts based on all tags and not just the first one.


  29. Vincent says:

    (revised comment)
    I’ve been looking for a way of adding POSTS related to specific tags on the bottom of PAGES I have created. EG: POSTS that are related to the pyramid of Teti…

    …on the bottom of the Pyramid of Teti PAGE:

    At the moment I’ve just added the tags at the bottom of the PAGE but would be much better to have exerpts of the related POSTS added.

    Is there a way I can adapt the code that you have given to do this?


  30. matthew says:

    Great tip! thanks for sharing this

  31. Dario Gutierrez says:

    Excellent, buy how can i put a thumbnail? Thanks.

  32. Sal Surra says:

    Great tip! Works perfectly and thanks for sharing this. I like the tip as it shows my recent posts in a nice lists view.

  33. palmamod says:

    Hey, I implemented the non-plugin version of this and am 99% happy with it. I know it’s not you who have developed it but maybe you could help. If you check the posts on my blog, you will see that 5 posts are displayed (matching the first tag of the post) but “in line”. Do you know how can I tweak this so that a list occurs? Like, tweaking the php so that a and tags are created?
    Thanks a lot and keep up the good job!

  34. Vin says:

    I’ve been looking for a way of adding posts related to specific tags on the bottom of pages I have created. EG: Posts that are related to the pyramid of Teti…

    …on the bottom of the Pyramid of Teti page:

    At the moment I’ve just added the tags at the bottom of tghe page but would be much better to have exerpts of the related posts added.

    Is there a way i can adapt the code that you have given to do this?


    Do you have a link?

    • Editorial Staff says:

      Cannot access your site. Database connection error.

      For Sergej, use the link associated with his name. It takes you to his website and the link to the plugin is there.

  35. Sergej Müller says:
  36. Ileaneb says:

    Does this work for as well? Are the instructions the same?

    • Editorial Staff says:

      If you can install the plugin, then yes it will work. If you can change the codes in theme then it will work.

Add a Comment

We're glad you have chosen to leave a comment. Please keep in mind that all comments are moderated according to our comment policy, and all links are nofollow. Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.