|  Pipeline theme
Pipeline v6

Cart upselling

Use the metafield name theme.upsell to have your product upsells follow customers into the cart.
Feature added in Pipeline 6.1
Double your upsell opportunities with uniquely paired products that appear on both the Cart and individual Product pages. Each product can have its own custom "Buy it with" upsell promotion:
Second upsell opportunity, the Cart
Pipeline uses Shopify's Dynamic source feature, metafields, to pair products with other products.

How to configure your theme.upsell metafield

There are two initial steps involved when setting up custom paired products:
  1. 1.
    Create an upsell metafield with the namespace and key: theme.upsell
  2. 2.
    Connect the metafield in the Theme Editor
After the initial setup, each product can easily be paired with other products using your Shopify Admin under Product setup.
The first step is to define a product metafield with the namespace and key of theme.upsell and type Reference to Product:
Namespace and key is theme.upsell
  • The namespace begins with theme. Example: theme.upsell. This is required to allow the upsell to follow users into the cart. The namespace is theme and the key is upsell.
  • The metafield type is Reference, Product
The same metafield can be used for product and cart upsells
If that sounds complicated, we've made an easy-to-follow 1-minute video, to demonstrate exactly all the steps needed for creating this type of metafield. This is only required once and is simple to do in your Shopify Admin.

Video 1: Creating the upsell metafield

Watch this 1-minute video on how to create the correct type of upselling metafield:
1min video

Video 2: Connecting the upsell metafield

After creating the upsell metafield, we can connect it to Pipeline using the Theme Editor. Watch this 1-minute video on how to connect the upsell metafield:
53 second video
Steps covered in the video:
  1. 1.
    Add the upsell theme block.
  2. 2.
    Configure the upsell theme block to connect with the upsell metafield

Pairing products for upselling

After defining your upsell metafield and connecting it in the Theme Editor, you're ready to pair products together. This step is very simple and is managed in your Product setup of the Shopify Admin.
For each individual product, select a pairing product. The paired product will appear as the "Buy it with" promotion on both the product page and the Cart:
Choose the upsell product to pair with

Cart styles

Cart promotions will appear when using either of these cart styles in Pipeline:
  • Popup
  • Drawer
Cart styles are found in the Theme Settings

Single variant products

When selecting a product for the "Buy it with" promotion, we recommend you choose products with one variant. The one-click Add to Cart button adds the default variant to the Cart with no variant selection. Upsell products work best when they have one variant.
If your products contain multiple variants, create a product for promotional use only modeled from the main variant version. Exclude that product from collections.