Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
WPB Cup
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

How to Show Related Pages in WordPress (2 Methods)

Displaying related pages in WordPress improves user engagement and keeps visitors on your website longer. It can be hard to keep users interested, but showing them related posts is an excellent way to guide them to additional content they may find valuable.

On WPBeginner, we regularly link to relevant articles from the same SEO topic cluster to help our readers find more help on the same subject. But this can be a lot of work, and you may prefer to show related pages automatically with a plugin or using code.

In this article, we will show you how to easily show related pages in WordPress so you can improve user experience and connect your users with more content.

How to Show Related Pages in WordPress

Why Show Related Pages in WordPress?

Displaying related content is a great way of keeping your visitors on your WordPress website. You can show your top pages in your content to boost user engagement and increase pageviews.

It also helps improve the visibility of your most important pages. When your website starts to grow and has lots of landing pages, it can be difficult for users to find new content.

Using related pages, you can solve this issue and display your best content where people can easily find them. This way, you can retain users and increase the time they spend on your website.

Another benefit of showing related posts is that it lets you create internal links to important pages. This allows search engines to find new content and boost your WordPress SEO.

That being said, let’s take a look at how you can display related posts in WordPress.

Showing Related Pages in WordPress Using a Plugin

The easiest way to display related pages on your website is by using the Yet Another Related Posts Plugin (YARPP) plugin. It’s a free WordPress related posts plugin that automatically displays top pages using an algorithm.

First, you will need to install and activate the Yet Another Related Posts Plugin (YARPP) plugin. If you need help, then please refer to our guide on how to install a WordPress plugin.

Upon activation, you can go to Settings » YARPP from your WordPress admin area to configure the plugin.

Change YARPP pool settings

The plugin lets you choose whether you want to show posts, pages, and media in the related posts on your website. You can go ahead and check the ‘Pages’ checkbox.

There are more options to disallow content from certain categories and tags, display password-protected content, select a time period for determining related posts, and more.

After that, you can change the algorithm settings in YARPP under the ‘The Algorithm’ section.

Algorithm settings in YARPP

The most important setting is the ‘Match threshold’, which tells the plugin how strict the algorithm should be in finding related content. The higher the number, the more strict the algorithm will be.

By default, the match threshold will be set to 1, which means the algorithm will be less strict in determining related pages. However, you can increase it to a maximum limit of 5.

We recommend that you start with the default setting. Once you begin to add more pages to your website, then you can adjust the threshold.

Other settings you can tweak in the algorithm include titles, bodies, categories, and tags when finding related pages.

Next, you can change how your related pages will appear on your website by scrolling down to the ‘Automatic Display Options’ section.

Automatic display options

The plugin lets you automatically show related content on posts, pages, and media. You can set the maximum number of posts to show in the related pages widget and choose a theme.

There are 3 theme options available in the YARPP plugin. You can select a list, thumbnails, or add a custom theme for your related pages. For each theme, you also get different options for customization.

You can also choose the order of your related page results from the ‘Order results’ dropdown menu. YARPP shows related pages based on the threshold score, date, or title.

The plugin will also show a preview of your related pages that will appear on the website. You can change the preview mode to mobile, tablet, or desktop.

Preview of related pages

Next, you can scroll down and enable the RSS feeds option and REST API options.

Once you have edited the settings, go ahead and click the ‘Save Changes’ button.

Change RSS options and save changes

The WordPress plugin will now automatically display related pages on your website.

You can visit any post or page to see the related pages in action.

Related pages in WordPress

Please note that YARPP, along with some other WordPress plugins, is blocked by several managed WordPress hosting providers due to its heavy database usage.

If you come across this issue, then you can show related pages without using a plugin.

Showing Related Pages in WordPress Using Code

The most efficient way to display related posts is by looking for tags or categories. Since WordPress pages do not have tags or categories, you will need to add them using a WordPress plugin.

First, you will need to install and activate the Pages with category and tag plugin on your website. For more details, please see our guide on how to install a WordPress plugin.

Next, you will need to add tags to your WordPress pages to build contextual relationships.

You can go ahead and edit any page on your website and enter tags in the ‘Tags’ settings box in the WordPress editor.

Add tags in WordPress

After that, you can add tags for all the pages you want to relate to each other. For example, if you have multiple pages about your company, like a privacy policy page and a contact us page, then you can add a ‘company’ tag.

After you have added tags to a few pages, the next thing to do is to add some code to your theme.

Often, tutorials will tell you to edit your theme’s functions.php file. However, if you make any mistakes, you could cause WordPress errors or break your site completely.

That’s why we recommend using the free WPCode plugin instead. You can follow the instructions in our guide on how to easily add custom code in WordPress.

The first thing you need to do is install and activate the WPCode Free Plugin. For detailed instructions, see our beginner’s guide on how to install a WordPress plugin.

Next, head over to the Code Snippets » + Add Snippet page in your admin area. Point your mouse cursor at the ‘Add Your Custom Code (New Snippet)’ option and then click the ‘Use snippet’ button.

Adding Custom Code in WPCode

This will open a page where you can add a custom snippet.

First, give the snippet a title that describes what the snippet does, such as ‘Show Related Pages in WordPress’. After that you should paste the following PHP code into the Code Preview area.

function wpb_related_pages() {
$orig_post = $post;
global $post;
$tags = wp_get_post_tags($post->ID);
if ($tags) {
$tag_ids = array();
foreach($tags as $individual_tag)
$tag_ids[] = $individual_tag->term_id;
$args=array(
'post_type' => 'page',
'tag__in' => $tag_ids,
'post__not_in' => array($post->ID),
'posts_per_page'=>5
);
$my_query = new WP_Query( $args );
if( $my_query->have_posts() ) {
echo '<div id="relatedpages"><h3>Related Pages</h3><ul>';
while( $my_query->have_posts() ) {
$my_query->the_post(); ?>
<li><div class="relatedthumb"><a href="<? the_permalink()?>" rel="bookmark" title="<?php the_title(); ?>"><?php the_post_thumbnail('thumb'); ?></a></div>
<div class="relatedcontent">
<h3><a href="<? the_permalink()?>" rel="bookmark" title="<?php the_title(); ?>"><?php the_title(); ?></a></h3>
<?php the_time('M j, Y') ?>
</div>
</li>
<? }
echo '</ul></div>';
} else {
echo "No Related Pages Found:";
}
}
$post = $orig_post;
wp_reset_query();
}
Showing Related Pages Using WPCode

Having done that, you need to select ‘PHP Snippet’ from the Code Type drop-down and then click the ‘Active’ setting so the toggle turns on.

Make sure you click the ‘Save Snippet’ button to store the code.

Showing Related Pages Using WPCode

This code looks for tags associated with a page and then runs a database query to fetch pages with similar tags.

To display the list of pages, you will need to edit your page template. Most commonly, it is the page.php file. Simply add this line of code where you want related pages to appear:

<?php wpb_related_pages(); ?>

This will display related pages on any WordPress page. If you want to change the styling and appearance of your related pages, then you will need to add custom CSS to match your theme.

You can then visit your website to view the related pages in action.

Related pages without plugin preview

Expert Guides on Showing Important Posts and Pages in WordPress

We hope this article helped you learn how to display related pages in WordPress. You may also want to see some other guides related to showing important posts and pages:

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.

Disclosure: Our content is reader-supported. This means if you click on some of our links, then we may earn a commission. See how WPBeginner is funded, why it matters, and how you can support us. Here's our editorial process.

Editorial Staff

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

The Ultimate WordPress Toolkit

Get FREE access to our toolkit - a collection of WordPress related products and resources that every professional should have!

Reader Interactions

15 CommentsLeave a Reply

  1. kzain

    I love the step-by-step instructions for using plugins and manual coding – both methods are clearly explained and easy to follow.
    One question I have: how does the performance of related pages generated by plugins compare to those created with manual coding in terms of page load speed and SEO impact? Is there a preferred method for larger sites with extensive content?

    • WPBeginner Support

      There should not be a major performance change between the code and the plugin. The plugin would be more likely to have better speed in the long term.

      Admin

  2. Riccardo

    Your code does not work.
    You wrote line 26: <?
    instead of: <?php

  3. Alperen

    Hi, thanks i just wanna ask something. İ dont wanna use a plugin to add tags or category on pages. İ just have a custom taxonomy for some pages and some post. And i wanna display related pages is by looking for custom taxonomy. İs there a solution ?

  4. panos gew

    hey there. completely new, so i havea question, where should i put this line of code ->
    Do i have to put this line in functions.php as well?And if yes, i dont want related pages to show up in ANY SINGLE page…

    • WPBeginner Support

      No you need to put it in the template where you want to display related posts. Like single.php, category.php, etc.

      Admin

  5. George

    Thank you! Works for me. :)

  6. WPBeginner Fan

    My question is what is the code for conditional statement? Something like function_exists ?

  7. Marcelo Luiz

    Would it be possible to get a list of pages sisters in a certain hierarchy of pages parents?

  8. Ayebal John Bob

    My major question is how do I put in that div that I will need to style in the css

  9. Rich

    To reiterate Al Harji’s comment, this tutorial was very timely as this was something I was starting on today with my site. However, when I went to install both YARPP and CRP, WP showed “not available” for both. I’m using GoDaddy’s Managed WP with 2014 theme. This is the first time I’ve received this message for any plugin. Checked the WP support forum but no luck. Any ideas?

  10. Gerald

    I was using YARPP for quite a while. The template part is really awesome but so far I didn’t thought about related PAGES. Great idea for an upcoming project. Thanks for the tip!

    • Al Harji

      Great tutorial as always, this one is so timely – thank you!

      Ajay, your plugin looks amazing. I am looking forward to trying it and also impressed with so many positive reviews. I use your Top 10 plugin which I love as well.

Leave A Reply

Thanks for choosing to leave a comment. Please keep in mind that all comments are moderated according to our comment policy, and your email address will NOT be published. Please Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.