# Product recommendations

{% hint style="info" %}
Check out similar features like [Complementary products](/stiletto/product-pages/product-page-blocks/complementary-products.md) for the product page and [Cross sells](/stiletto/cart/cross-sells.md) in the cart to show customers related products that they can purchase in addition to the selected product.
{% endhint %}

In the Product template, the **Product recommendations** section displays similar products to customers on product pages. Product recommendations let customers discover new products and can increase sales.

Recommendations are automatically generated based on products in related collections, products that are commonly purchased together, or similar product descriptions. Recommendations improve over time with more customer and product information. You can **customize product recommendations** by downloading Shopify's [Search & Discovery app](https://apps.shopify.com/search-and-discovery).

![](/files/QUprPOueP0DG7xnZJzSp)

## **Set up section**

Follow the steps to set up the **Product recommendations** section. You can customize the section headings, the number of recommend products, and the section style.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click the **Product recommendations** section in your products template.

   > To add this section, click **(+) Add section** and select **Product recommendations**.
2. Enter **Heading** text to display as the section title.
3. (*Optional*.) Enter **Subheading** text to display beneath the Heading.

   > Use the formatting buttons to add bold, italic, or link text.
4. Set the **Maximum number of products** to display in the section. Choose between **2** and **15** products.
5. Set a specific **Number of columns** to display on **Desktop** and **Mobile**.

   Choose between **3** and **5** columns of product for **Desktop** screens. Choose between **1** and **1** for mobile devices.
6. Choose to **Enable animation** to show visual effects when scrolling, hovering, or interacting with the section.

   > Learn more about [Section animations](/stiletto/theme-styles/animation.md) in Stiletto.
7. Choose to display a **Top divider** that separates sections with a **Solid** line.

   > The Top divider uses the color of **Lines and borders** set in the Theme settings.
8. Select a **Padding** option to change the spacing between sections. Choose between **Top and bottom**, **Top only**, **Bottom only**, or set it to **None**.
9. Click **Save**.

</details>

## **Customize recommendations**

With Shopify's [Search & Discovery app](https://apps.shopify.com/search-and-discovery), you can customize which products are recommended.

Download Shopify's [Search & Discovery app](https://apps.shopify.com/search-and-discovery) and learn how to [choose recommended products](https://help.shopify.com/en/manual/online-store/search-and-discovery/product-recommendations) for your store’s product pages.

{% hint style="warning" %}
Using automated recommendations ensures that only in-stock and published products are displayed. **If you manually select recommended products**, make sure your product list is up-to-date.
{% endhint %}

## Settings reference

In the Product template, click the **Product recommendations** section to find the following settings.

#### **Section content**

Add heading and subheadings at the top of the section.

| Setting    | Description                                           |
| ---------- | ----------------------------------------------------- |
| Heading    | Add text to show a main heading above the section.    |
| Subheading | Add text to show a subheading below the main heading. |

#### **Product list**

Change the layout of the product cards on desktop and mobile.

| Setting                      | Description                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------------ |
| Maximum number of products   | Set a limit on how many product recommendations to display within the section: between 3 and 15. |
| Number of columns on desktop | Choose how many recommendations to show per row on desktop screens: either 3, 4, or 5 columns.   |
| Number of columns on mobile  | Choose how many collections to show per row on mobile screens: either 1 or 2 columns.            |

#### **Section style**

| Setting          | Description                                                                                                                                                                                        |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable animation | <p>Choose whether to display visual effects when scrolling, hovering, or interacting with the section.<br><br>See our <a href="/pages/x3Rlhb4LqJjyu0IhUpI3">Animation guide</a> to learn more.</p> |
| Top divider      | Show a border line at the top of the section.                                                                                                                                                      |
| Padding          | Add spacing between sections. Choose between Top and bottom, Top only, Bottom only, or set it to None.                                                                                             |

\\

***

> **Related links**
>
> [Product template](/stiletto/product-pages/product-template.md)\
> [Complementary products](/stiletto/product-pages/product-page-blocks/complementary-products.md)\
> [Recently viewed products](/stiletto/sections/theme-sections/recently-viewed-products.md)\
> [Cross-sells](/stiletto/cart/cross-sells.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.fluorescent.co/stiletto/product-pages/product-page-sections/product-recommendations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
