> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shopify.lightsout.agency/llms.txt
> Use this file to discover all available pages before exploring further.

# Show related blog posts under an article in Facet

> Add Facet's related posts section to the blog post template to list other articles from the same blog, and set the heading, post count and columns.

The Facet related posts section lists other articles from the same blog under a blog post. It keeps readers on your blog after they finish an article. This page covers where the section works, which posts it picks, and its settings.

![The Related posts section as it appears on the Facet demo storefront.](https://mintcdn.com/lightsout/Svjpo54WQSiE2VRv/images/themes/facet/sections/related-posts/related-posts-overview.jpg?fit=max\&auto=format\&n=Svjpo54WQSiE2VRv\&q=85\&s=b70859e494bb97cd76e152a136dd04dd)

## What this section controls

* The heading above the posts.
* How many posts show.
* Two or three columns on large screens.

## Which posts show

There is no picker. The section shows the newest articles from the blog the current article belongs to, and skips the article being read. The section is hidden when the blog has only one article.

> [!NOTE]
>
> Related posts only works on the blog post template. You can't add it to other pages.

## Getting started

**1. Open the Theme Customizer**

In your Shopify admin, open **Online Store**, then **Themes**, and click **Customize** next to Facet.

**2. Open a blog post**

Use the page selector at the top to open **Blog posts**, then **Default blog post**.

**3. Add the section**

Click **Add section** and choose **Related posts**. Drag it under the article.

![The theme editor with the Related posts section selected in the sidebar, its settings panel open on the left and the section highlighted in the preview.](https://mintcdn.com/lightsout/Svjpo54WQSiE2VRv/images/themes/facet/sections/related-posts/related-posts-location.jpg?fit=max\&auto=format\&n=Svjpo54WQSiE2VRv\&q=85\&s=130e2a51cfad073170254719e577c2e9)

## Section settings

![Theme editor sidebar showing the Related posts section settings: Heading, Posts to show, Columns, Common settings, Color scheme, Top padding, and more.](https://mintcdn.com/lightsout/Svjpo54WQSiE2VRv/images/themes/facet/sections/related-posts/related-posts-settings-1.png?fit=max\&auto=format\&n=Svjpo54WQSiE2VRv\&q=85\&s=079b3a9774d377d40ed9a84adc658294)

![Theme editor sidebar showing the Related posts section settings (part 2, scrolled): Posts to show, Columns, Common settings, Color scheme, Top padding, Bottom padding, and more.](https://mintcdn.com/lightsout/Svjpo54WQSiE2VRv/images/themes/facet/sections/related-posts/related-posts-settings-2.png?fit=max\&auto=format\&n=Svjpo54WQSiE2VRv\&q=85\&s=6a92a0ccdc2aa21f6d1d9dbeac0c8609)

* **Heading**: the title above the posts. Default: "Related posts". Leave it empty to hide it.
* **Posts to show**: from 2 to 6. Default: 3.
* **Columns**: **2** or **3** (default) on tablets and larger screens. Phones show one post per row.

### Common settings

* **Color scheme**: the colors of the section.
* **Top padding**: None (default), Small, Medium, Large or Extra large.
* **Bottom padding**: None, Small, Medium, Large (default) or Extra large.
* **Page width**: Narrow, Narrower (default), Fluid or Full.

See [Common settings](https://docs.shopify.lightsout.agency/themes/facet/common-settings.md) for details.

## Best practices

* **Match the post count to the columns.** With 3 columns, show 3 or 6 posts so the last row is full.
* **Give every article a featured image.** The cards look uneven when some posts have a picture and others don't.
* **Use separate blogs for separate topics.** The section only looks inside the current article's blog, so a blog per topic keeps the suggestions on topic.

## Related guides

> [card] [Article](https://docs.shopify.lightsout.agency/themes/facet/pages-templates/article.md)
>
> Set up the blog post template this section sits on.

> [card] [Blog](https://docs.shopify.lightsout.agency/themes/facet/pages-templates/blog.md)
>
> Set up the page that lists every post.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.