# 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="https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/nvWF0EbZSdP3SdxwiKWY/upsell.png" 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;

![](https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/xdWeJr1kZbScQLcZQw35/theme-upsell-definition.png)

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

![Under 'Metafields', click on 'Products'](https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/qGchc8nbYBFIJ4kfPx6O/metafields-settings.jpg) ![Click on the 'Add definition' button](https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/qJ59M88CZ2MACcU28lQP/add-definition-button.jpg)

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`**

![](https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/rTHPf65cDvjJApcCCF7k/new-upsell-definition.gif)

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

![](https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/v22UbuC892BKI9Rt38nC/select-product-type.gif)

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

![](https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/EKjCMsdoErWlRw4BHYRi/add-new-upsell-to-product.gif)

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

<figure><img src="https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/2zNxfxtQuPFPrvkTaYRo/upsell-product.png" 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="https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/sEAM41FV6gveTEmfxDKP/upsell-list-definition.gif" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/qTn1l3QRR57s3N5b0bsQ/product-list-type.gif" 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="https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/J9RfOHSv6tSIUa5EyZG0/upsell-list-setup.gif" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/vKTfahXsWzBXjkEUjgYR/blobs/0DcWFnGJZZnENzbm4HBO/upsell-changes.gif" alt=""><figcaption></figcaption></figure>
