# Upselling with metafields

### Overview

Broadcast makes it easy to customize upsell products with two custom metafield types:

* Single product: Pair a unique product as an upsell.&#x20;
* List of products: Suggest multiple product promotions for any product.

These can be custom-chosen products for each of your products, eliminating the need to use multiple product templates.&#x20;

### Cart promotions

A second chance is available to the customer in the Cart drawer. If the customer doesn't use the Product page upsell promotion, they will have another opportunity in the Cart drawer:

<figure><img src="https://2636770384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsD7BEEDU3B7WiEJlN0F7%2Fuploads%2FJLTuc7ta7cDu280QGshX%2Fcart-promotions.gif?alt=media&#x26;token=6618c6ab-87c8-4d64-a464-3fb8afca83ec" alt=""><figcaption></figcaption></figure>

### How to use

To use the metafield feature in Broadcast, you'll first need to create a custom metafield. Once the metafield has been created, you can easily customize any of your products to use unique pairings.&#x20;

### Create the custom metafield

Create the custom metafield. There are two options: a single product or a list of products. We'll use the product list version in our examples. The product list version is flexible; you can use one or up to three products as upsell promotions.&#x20;

### Video Overview

Watch this video to learn how to correctly create the custom required metafield and set up your products:

{% embed url="<https://www.loom.com/share/eb1b823dbed94e5d96911ec49cbd8e8c?sid=733a6e41-3458-4a0d-b9b1-b381f19b7227>" %}
Video demonstrating the required steps for theme.upsell\_list and how to use with your products
{% endembed %}

### Key points from the video

Create the custom metafield that's designed for Broadcast:

{% hint style="info" %}
Create a product metafield with a unique namespace and key called: **`theme.upsell_list`**
{% endhint %}

* Be sure to change the default namespace of "custom" to "`theme`" and the key must be "`upsell_list`"

<figure><img src="https://2636770384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsD7BEEDU3B7WiEJlN0F7%2Fuploads%2FJ2DiypKtGozQvlY6cMeV%2Fopera_F3C3Xh9aEL.gif?alt=media&#x26;token=1e50661c-d8b9-4a8f-ba12-7523c90af150" alt="Gif Showcasing how to create an upsell metafield for the upsell setup"><figcaption></figcaption></figure>

### Set up the upsell block

Once you've created the metafield, the next step is to choose the metafield in the Theme Customizer's block settings:

<figure><img src="https://2636770384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsD7BEEDU3B7WiEJlN0F7%2Fuploads%2FboG2IsrDmGPkCXuyFOlA%2Fadd-upsell-list.gif?alt=media&#x26;token=69b631d4-0f42-4b44-8b1a-eac61c738326" alt=""><figcaption></figcaption></figure>

### Pair products in the Product setup

Use the Shopify Product Admin to pair your products with those of others. Repeat for other products in your store.&#x20;

<figure><img src="https://2636770384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsD7BEEDU3B7WiEJlN0F7%2Fuploads%2FNTGpsWtYMR7WKqQN9s6g%2Fproduct-setup.gif?alt=media&#x26;token=2bf0bf03-e697-4d51-a904-06f51a06d486" alt=""><figcaption></figcaption></figure>

Each product will automatically generate an upsell promotion on its product page and in the cart. Select one product for a single pairing or up to three products for a list of recommended products.&#x20;

{% hint style="success" %}
Watch the video above for full details on how to correctly complete all the steps.&#x20;
{% endhint %}

## Earlier versions

If you're using an older version of Broadcast that only supports **single product** upsell promotions, the metafield you will need to create is:

`theme.upsell`

This metafield allows you to choose one product pairing. Newer versions of Broadcast can use both metafields, a single product, and a product list.&#x20;


---

# 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://broadcast.presidiocreative.com/promotions/upselling/upselling.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.
