# Upselling with tags

> This article is for **Broadcast v3.0 to v3.3.1 only**. Tags are not supported as of v3.4

With Broadcast, you can suggest a pairing product on any of your Product pages. This allows the customer to purchase two separate products within one product page.

### Two upsell opportunities

> **One** - Broadcast can suggest a product to pair with. The customer can choose the upsell product from the Cart after adding the primary product.

<figure><img src="/files/kagjZ17cta1SS2MNP1nj" alt=""><figcaption><p>Paired with product appears as an option in the cart</p></figcaption></figure>

> **Two** - Customer can add the upsell product to the Cart directly from the main product page and also add the primary product to Cart.

<figure><img src="/files/Z6aQrzZ2r0jXGE2uutIt" alt=""><figcaption></figcaption></figure>

## How to:

There are two steps involved with setting up upselling:

{% hint style="success" %}

1. Add the Upsell theme block to the default product template
2. Tag your product with a custom upsell tag to pair/link with another product
   {% endhint %}

### 1. Add the Upsell theme block to the default product template

<figure><img src="/files/2re0bSf1SRMCXAPp51uV" alt=""><figcaption></figcaption></figure>

#### Position the upsell promotion

Use drag-and-drop to position the upsell theme block on your product page:

<figure><img src="/files/fQMs1p4nwqxL5pPEkofS" alt=""><figcaption></figcaption></figure>

### 2. Tag your product with a custom upsell tag to pair with another product

To pair a product with another, you simply add a tag to the main product with a custom tag. The tag links to the upsell product or links directly to a variant of the upsell product.

Here's an example of a primary product called 'Ilona Signet Ring in Sterling Silver'. We'll add the custom upsell tag here. This tells Broadcast that when a customer is viewing the 'Ilona Signet Ring in Sterling Silver' product page, a separate product can be suggested as an upsell. The upsell product is the custom tag (Ilona ring in gold):

<figure><img src="/files/MqKCJkEvG5u8apDfKM5Q" alt=""><figcaption><p>Custom '_upsell_ilona-ring-in-gold' tag added</p></figcaption></figure>

We simply add a tag called '\_upsell\_ilona-ring-in-gold' to 'Ilona Signet Ring in Sterling Silver', which implies that 'Ilona ring in gold' is the product we want to promote on the 'Ilona Signet Ring in Sterling Silver' page.

## Creating upsell tags

There are three parts to creating your custom upsell tags:

1. The first part of the tag must start with `_upsell_`
2. The second part of the tag must match the product handle of the upsell item
3. The last part is the variant ID. This is only required for products with variants.

Example of a completed tag without variants: `_upsell_ilona-ring-in-gold`

#### Variants

Broadcast can suggest more than just an upsell product. Broadcast can suggest an exact variant of a product to upsell. This can be helpful if you're trying to upsell a certain color or size of the product.

Example of a completed tag for a product that has variants: `_upsell_ilona-ring-in-sterling-silver_40854006726691`

### Finding the product handle

All Shopify products have a unique product handle. You can easily find the product handle in the main Shopify Admin under Products. Choose any product in your Shopify Admin for Products, then simply use the 'Edit' link to view details about that product, including the handle:

<figure><img src="/files/ih6Uf4N0xDlBnWdLPkfD" alt=""><figcaption><p>Product handle is 'Ilona Signet Ring in Sterling Silver'</p></figcaption></figure>

### Finding the product variant ID

All Shopify products with variants have a unique ID number associated with the product.

To find the variant ID, browse the product in your Shopify Product Admin, choose the Edit button next to the desired variant, and find the variant ID at the end of your browser URL address:

<figure><img src="/files/bbGcoiMqYMkKIkzj49SH" alt=""><figcaption><p>Variant ID is the last number in your browser's address bar</p></figcaption></figure>

{% hint style="success" %}
Remember, only products with one or more variants require the variant ID in the upsell tag. If your product has no variants (like our Ilona ring in gold example) you only need the prefix and handle.
{% endhint %}

{% hint style="warning" %}
Cart upsell promotions are only supported when Cart Drawer is enabled in the Theme Settings.
{% endhint %}

## Changing the 'Complete the look' heading

The main heading for this block uses a translatable string:

<figure><img src="/files/T0rCAX9ImoTPjz7RFvdV" alt=""><figcaption></figcaption></figure>

To change this heading you can go into your Online Store -> Edit default theme content:

<figure><img src="/files/Cit3J0622mDllWi2qDWp" alt=""><figcaption></figcaption></figure>

In the Products tab edit the 'Upsell title' field:

<figure><img src="/files/8Sk1vry4dvpUbiiW3WtA" alt=""><figcaption></figcaption></figure>

Save the changes and check your Product pages:

<figure><img src="/files/Z4NUbt18UA4i9p99PW9v" alt=""><figcaption></figcaption></figure>


---

# 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 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-with-tags.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.