# Upsell

The **Upsell** block is designed to promote related or complementary products directly on the product page. This block helps increase average order value by suggesting relevant items that the customer may also be interested in purchasing.

You can display a **single product** or a **small list of products** (up to 3), and optionally enable a **slider layout** or stick with the stacked layout depending on your preference. Upsells can also follow the customer into the cart when using linked metafields.

> Only one Upsell Block is allowed per section (`limit: 1`).

<figure><img src="/files/JwePSe6WTJupDCF3GC26" alt="GIF depicting the Upsell block settings of the product pages section"><figcaption></figcaption></figure>

<table><thead><tr><th width="207.7413330078125">Settings</th><th width="142.209228515625" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td>Single product</td><td align="center"><code>product</code></td><td>Select one upsell product to display.</td></tr><tr><td>Product list</td><td align="center"><code>product_list</code></td><td>Choose up to 3 upsell products. Overrides the single product if used.</td></tr><tr><td>Show only items in stock</td><td align="center"><code>checkbox</code></td><td>Display only upsell items that are currently available.</td></tr><tr><td>Layout</td><td align="center"><code>select</code></td><td>Choose layout style: <code>Stacked</code> or <code>Slider</code>. Pagination styles can be customized under Layout > Appearance.</td></tr><tr><td><strong>Slider</strong></td><td align="center"></td><td></td></tr><tr><td>Auto-rotate slides</td><td align="center"><code>checkbox</code></td><td>Enables automatic sliding for the upsell carousel.</td></tr><tr><td>Change slides every</td><td align="center"><code>range</code></td><td>Set the time interval for slide change when autoplay is enabled.</td></tr><tr><td><strong>Colors</strong></td><td align="center"></td><td></td></tr><tr><td>Background</td><td align="center"><code>color</code></td><td>Set a custom background color. Set to 'Transparent' to revert to the theme’s color scheme.</td></tr><tr><td><strong>Padding</strong></td><td align="center"></td><td></td></tr><tr><td>Bottom</td><td align="center"><code>range</code></td><td>Adjust bottom spacing of the block.</td></tr></tbody></table>

## Notes

* Using [**dynamic metafields**](https://broadcast.presidiocreative.com/promotions/upselling/upselling) allows your upsell selections to appear in both the product page and cart.&#x20;
* The **slider layout** is ideal for visual variety and works well on mobile devices.
* If both **single product** and **product list** are set, the list takes priority.


---

# 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://broadcast.presidiocreative.com/product-theme-blocks/upsell.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.