> For the complete documentation index, see [llms.txt](https://palo-alto.presidiocreative.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://palo-alto.presidiocreative.com/palo-alto-4.6/upsell/upsell.md).

# 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>
