# Upsell

The Upsell block is designed to increase average order value by showcasing complementary products that customers can quickly add to their cart, ideally with no variants for seamless one-click purchase.

<figure><img src="/files/wX5lzBAzxp2hrkOfFo8F" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
When selecting a product for the 'Buy It With' promotion, we recommend you choose products with one variant.
{% endhint %}

### How to set up

<table><thead><tr><th width="145.94873046875">Setting</th><th width="139.493896484375" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td>Product list</td><td align="center"><code>product_list</code></td><td>Select up to 3 products to feature in the upsell carousel. Use the <code>theme.upsell_list</code> metafield for dynamic content.</td></tr><tr><td>Padding bottom</td><td align="center"><code>range</code></td><td>Adds space beneath the block.</td></tr></tbody></table>

Select the upsell product. It will only be displayed on the product page.

You can also use a metafield namespace and key '`theme.upsell`' to allow product upsells to follow users into the cart.

<figure><img src="/files/EKU9wOpcbDdBpL1j5yYR" alt=""><figcaption><p>Settings -> Metafields and metaobjects -> theme.upsell_list</p></figcaption></figure>


---

# 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://palo-alto.presidiocreative.com/products/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.
