# Upsell

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

![](https://content.gitbook.com/content/PE3dRxQBXFmV7YrNe4E9/blobs/KmDiNCMeOMhoWqsh849W/cart-upsell-demo.jpg)

## 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/PE3dRxQBXFmV7YrNe4E9/blobs/QBT1QaL3UmUVQcUPbnzG/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/PE3dRxQBXFmV7YrNe4E9/blobs/8BrTQNvBvYzxufEsawxv/metafields-settings.jpg) ![Click on the 'Add definition' button](https://content.gitbook.com/content/PE3dRxQBXFmV7YrNe4E9/blobs/KdjAFkA29xI2FuztmUFg/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/PE3dRxQBXFmV7YrNe4E9/blobs/zu1ZDSTtdy9ycNSELNg0/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/PE3dRxQBXFmV7YrNe4E9/blobs/wUFaJNByzU8l0ZQfU3fP/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/PE3dRxQBXFmV7YrNe4E9/blobs/vWnkm4bYEzvFON56qZrr/add-new-upsell-to-product.gif)

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

![](https://content.gitbook.com/content/PE3dRxQBXFmV7YrNe4E9/blobs/AMniQugnCY574PEHyTEI/upsell-final.jpg)

## 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/PE3dRxQBXFmV7YrNe4E9/blobs/B99u537Ba3unztE9DiB5/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/PE3dRxQBXFmV7YrNe4E9/blobs/ZI80DXCqAwo8serY4dz1/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/PE3dRxQBXFmV7YrNe4E9/blobs/WnMe86UGmbOKXOIwC7KO/upsell-list-setup.gif" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/PE3dRxQBXFmV7YrNe4E9/blobs/WRsueuXQVRPfXbiOEHHY/upsell-list-demo.gif" alt=""><figcaption></figcaption></figure>
