# Upsell

Upsell products in the cart and product pages using a custom metafield definition. You can set different combinations for different products.

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

## Upsell one product

### Setting up the new metafield definition

Create a new metafield definition. Use the namespace and key: `theme.upsell`&#x20;

![](/files/ZSeZbggwEhS5NtTeFuxh)

From your Shopify Admin -> Settings and choose Metafields. Next, click on **Products** *(click images to zoom)*:

![Under 'Metafields', click on 'Products'](/files/ErPduo32vhorxsZOrFGj) ![Click on the 'Add definition' button](/files/slT0tc9NZAZaWfph5sNd)

Click the **Add definition** button and set a name, we'll use '`Upsell`'. Next, we will use a custom namespace.

This step is **required**. Change the **default namespace** (usually called '*my\_fields*') to **`theme`**

![](/files/IAJszADyARWt1ZduGsVs)

Add a description *(this is optional)* then click on **Select content type**. Here, choose the **Product** type and **Save** your new definitions.

![](/files/JW8TMlKXQgog9KWfq2EL)

### Product setup

The final step is to edit any of your products in the Shopify Admin -> Products and update the new `upsell` metafield.

All you need to do is scroll to the bottom of the product setup page and fill them in:

![](/files/vTiHrwLGx55YXlkFtlag)

Don't forget to **Save** your product and preview it on the cart drawer (or cart page).

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

## Upsell a list of products

### Setting up the new metafield definition

Create a new metafield definition. This time, use the namespace and key: `theme.upsell_list`&#x20;

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

Choose the Product type then set it to a 'List of products'.

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

### Product setup

The final step is to edit any of your products in the Shopify Admin -> Products and update the `upsell_list` metafield.

All you need to do is scroll to the bottom of the product setup page and fill them in.

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

Don't forget to **Save** the changes and test them out in the cart:

<figure><img src="/files/rhMYNV3N1uVkYFgPijfL" alt=""><figcaption></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/palo-alto-4.6/upsell/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.
