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

# Upselling with metafields

Promote products on product pages and the cart with custom metafields for precise product matching

### Overview

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

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

These can be custom-chosen products for each of your products without having to use multiple product templates. 

### 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://content.gitbook.com/content/j8jzXN4KKXAfQhgbN5lO/blobs/NegJO9gxGnP4m9khIS7j/basic-cart-example-upsell.gif" alt=""><figcaption></figcaption></figure>

### How to use

To use the metafield feature in Broadcast, you'll need first 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 product list. 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

Wath 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://content.gitbook.com/content/j8jzXN4KKXAfQhgbN5lO/blobs/rV0eZ0AEB6Oxdgqip976/theme.upsell_list.jpg" alt=""><figcaption></figcaption></figure>

### Setup 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://content.gitbook.com/content/j8jzXN4KKXAfQhgbN5lO/blobs/mwNpgUTjiJFn7EscV1V7/block%20settings%20upsell-less-zoom.gif" 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://content.gitbook.com/content/j8jzXN4KKXAfQhgbN5lO/blobs/vTqmQ5DzOq6pi9KOiqyc/choosing%20products.gif" alt=""><figcaption></figcaption></figure>

Each product will automatically generate an upsell promotion on product pages and the cart. Choose one product for a single pairing or up to three products for a list of product recommendations.&#x20;

{% hint style="success" %}
Watch the video above for full details on correctly completing 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://broadcast.presidiocreative.com/broadcast-v5/promotions/upselling/upselling.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.