> ## 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.

# Suggest related products on Facet product pages

> Add Facet's related products section to the product template, learn where its suggestions come from, and set the heading, product count and columns.

The Facet related products section shows a row of products similar to the one a shopper is viewing. It works only on the product template. This page explains where the suggestions come from and covers the section settings.

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

## What this section controls

* The heading above the row.
* How many products the row can show.
* How many cards fit across the screen on desktop.

## Where the products come from

There is no product picker. The section asks Shopify's product recommendations for products related to the one on the page. Shopify picks them from your sales and product information, and the list improves as your store gets orders.

To choose the suggestions yourself, use the free **Shopify Search & Discovery** app. Related products you set for a product in that app are part of these recommendations. The theme has no setting or metafield of its own for this.

When Shopify has no recommendations for a product, for example in a new store, the whole section stays hidden.

## 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 product page**

Use the page selector at the top to open **Products**, then **Default product**.

**3. Add the section**

Click **Add section** and choose **Related products**. Drag it under the product information.

![The theme editor with the Related products 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-products/related-products-location.jpg?fit=max\&auto=format\&n=Svjpo54WQSiE2VRv\&q=85\&s=4abe9579e00fec86850755ee95ee7bde)

## Section settings

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

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

* **Heading**: the title above the row. Default: "You may also like".
* **Products to show**: from 2 to 12. Default: 8. Shopify may return fewer.
* **Desktop columns**: **3 columns**, **4 columns** (default) or **5 columns**. Phones show 2 cards across and tablets 3. Shoppers scroll the row sideways to see more.

The row has previous and next arrows beside the heading and dots under the cards. Each card has a quick add button.

### Common settings

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

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

## Best practices

* **Curate your best sellers.** Set related products for your top products in Search & Discovery so their suggestions are always on brand.
* **Place it under the product information.** Shoppers see the suggestions after they have read about the product, not before.
* **Check a new product in a preview.** If the row doesn't show, Shopify has no suggestions for it yet.

## Related guides

> [card] [Product page](https://docs.shopify.lightsout.agency/themes/facet/products/product-page.md)
>
> Set up the product template this section sits on.

> [card] [Recently viewed](https://docs.shopify.lightsout.agency/themes/facet/sections/recently-viewed.md)
>
> Bring back products the shopper looked at before.


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