> For the complete documentation index, see [llms.txt](https://docs.lufavo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lufavo.com/roomfolk/sections/product-recommendations.md).

# Product recommendations

Products suggested alongside the one a customer is looking at. Two kinds, and the product page uses both by default.

## The two kinds

| Type                   | Where it comes from                                                      |
| ---------------------- | ------------------------------------------------------------------------ |
| Related products       | Shopify works these out automatically from your catalog and your orders. |
| Complementary products | Products you choose yourself, in Shopify's **Search & Discovery** app.   |

**Related** needs nothing from you, but it needs data. On a brand-new store with no order history Shopify may return nothing, and the section then shows nothing rather than an empty heading. It fills in as your store gets traffic.

**Complementary** is entirely yours. Install Shopify's free **Search & Discovery** app, open a product, and set which products go with it — the classic "goes well with" pairing.

## Set it up

1. Add the section to the product page.
2. Choose the **Recommendation type**.
3. To show both kinds, add the section twice and set each one differently.

## Content and products

| Setting             | What it does                                |
| ------------------- | ------------------------------------------- |
| Heading             | The section heading.                        |
| Recommendation type | Related products or Complementary products. |
| Products to show    | 2 to 10.                                    |
| Show view all link  | A link through to the collection.           |
| Link                | Where that link goes.                       |

Give the two sections different headings if you use both — "You may also like" for related, "Pairs well with" for complementary.

## Layout and card

| Setting                    | What it does                                 |
| -------------------------- | -------------------------------------------- |
| Layout                     | **Grid** or **Compact list**.                |
| Columns on desktop         | 2 to 4.                                      |
| Columns on mobile          | One column or two.                           |
| Aspect ratio               | Natural, Square, Portrait or Landscape.      |
| Show second image on hover | Reveals the product's second image on hover. |

**Grid or compact list:** a grid gives each product a full card with a large image. A compact list is a narrow scrolling row with small thumbnails — useful for the second recommendations section, so the two do not look identical.

## Spacing and style

| Setting        | What it does                   |
| -------------- | ------------------------------ |
| Top spacing    | 0px to 120px.                  |
| Bottom spacing | 0px to 120px.                  |
| Color scheme   | Which scheme the section uses. |

## When it loads

Recommendations load once the customer scrolls near them, rather than with the rest of the page. That keeps the product page fast, since working out recommendations takes Shopify a moment.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.lufavo.com/roomfolk/sections/product-recommendations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.