The Related Posts feature pulls relevant content from your blog to display at the bottom of your posts. This guide will show you how to display a list of related posts on your website.
Related Posts uses your post content, tags, and categories to automatically generate a list of relevant posts on your site:
Related content is automatically generated, so it’s not possible to hand-pick which posts are shown. To display specific posts, you can insert a Blog Posts block instead.
Related content will not appear unless the system can identify at least three good results.
Related Posts for a given article are cached for 12 hours, so if you change the title, image, or meta for a post, it will take some time to reflect in the Related Posts section of your site.
You can choose to display images along with your related posts. The image shown will be chosen in the following order:
- The post’s featured image.
- An image from a slideshow or gallery in the post.
- Any other images inserted into the post.
Images must be greater than 350px wide by 200px tall. Otherwise, they will not be included.
Thumbnails are resized and cropped automatically to be 350px wide by 200px tall (1.75:1 ratio) for consistent visual display. Since this is done automatically, there’s no way to fine-tune where the image is cropped.
There are two ways to add related posts to your blog posts, depending on what type of theme your site uses.
To determine which section of this guide to follow, visit your WordPress.com dashboard and check under Appearance on the left side. If you see Editor, use the Block Themes section of this guide. Otherwise, use the Classic Themes instructions.
On sites using block themes, you will insert a “Related Posts block” where you want the related posts to appear. Follow these steps to add a Related Posts block:
- Start at your WordPress.com dashboard.
- Depending on where you want to add the related posts, navigate to a page, post, or template and edit or create a new:
- Page: Navigate to the Pages section of your menu.
- Post: Navigate to the Posts section of your menu.
- Template: Navigate to Appearance → Editor and select the template.
- Click the plus icon and search for “Related Posts”.
- Or, type /related wherever you see “Type / to choose a block”.
It is only possible to insert one Related Posts block per page.
For more information, visit our detailed instructions on adding blocks.
After adding the block, it will display any relevant posts. If you do not have enough published posts, a message will say, “Preview unavailable: you haven’t published enough posts with similar content.” As you publish more related posts, the block will update with those new posts.
💡
The following sections apply only when the Related Posts block is used.
When you click on the block, a toolbar of options will appear above or below it:
The icons on the Related Posts block toolbar, starting from the left, are:
- Change block type
- Drag the block
- Move it up or down
- Change alignment (none, wide width, or full width)
- Switch to grid view: displays posts side-by-side.
- Switch to list view: displays the posts horizontally in a list format.
- Additional options
When you select a block, you will find additional block settings in the right sidebar. If you do not see the sidebar, you may need to click the Settings icon in the top-right corner to bring up the settings. This icon looks like a square with two uneven columns:
The Related Posts block contains the following settings:
- Display headline: Add a custom heading to appear above the related posts.
- Number of Posts: Control the number of related posts displayed. The default setting is 3 posts. You can display a maximum of 6 posts.
- Metadata settings:
- Display date: Show the date the post was published.
- Display author: Show the author of the post.
- Display context (category or tag): Show the contextual category or tag for the related post.
- Display thumbnail. Show an image from the relevant post.
The block also includes:
