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.
There are two initial steps involved when setting up custom paired products:
- 1.Create an upsell metafield with the namespace and key: theme.upsell
- 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
Verify:
- 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.
Watch this 1-minute video on how to create the correct type of upselling metafield:
1min video
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.Add the upsell theme block.
- 2.Configure the upsell theme block to connect with the upsell metafield
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 promotions will appear when using either of these cart styles in Pipeline:
- Popup
- Drawer

Cart styles are found in the Theme Settings
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.
Last modified 10mo ago