Product upsells show other products from your store inside the cart drawer, and shoppers add one to their cart with a single tap. You choose the products in one of two ways: let Shopify recommend them for whatever is in the cart, or write your own rules, such as "when this product is in the cart, offer that one". By the end of this you'll have upsells showing in your cart. You need at least one product in your store to offer.
In this article:
How to add product upsells
Open your cart upsell in the editor and click Product upsells, under Upsells.
Switch it on with the switch at the top of the panel. If you have no rules yet, Use AI-recommended products switches on with it.
In Content, set the title, button and position (see the table below).
In Products, either keep Use AI-recommended products on and pick an algorithm, or switch it off and add your own rules.
Click Publish. On a cart upsell that isn't live yet, you can click Save draft instead and publish later.
The Upsell drawer template starts with product upsells already on, using AI-recommended products.
If the feature is on but has nothing to offer, the panel shows “Nothing to offer yet.” with “Add a rule under Products, or use AI-recommended products, to show upsells in the cart.”
Content settings
Setting | Default | What it does | Shown when |
Upsell title | You might also like | The heading above the upsell cards. Up to 100 characters. | Always |
Button style | Icon | Icon shows a round cart button beside each product. Text shows a button with your text under the price. | Always |
Button text | Add | The add button's text. Up to 24 characters. | Button style is Text |
Position | Below items | Puts the upsells Below items or Above items in the cart. | Always |
Show upsell product if already in cart | On | On: a product stays on offer after the shopper adds it. Off: products already in the cart are left out. | Always |
Show compare-at prices | Off | Shows the product's compare-at price from Shopify crossed out next to its price, when the compare-at price is higher. | Always |
Colors settings
Setting | Default | What it colours |
Section background | #FFF | The area behind the upsells |
Slide background | #F6F6F6 | Each product card |
Button background | #FFF | The add button |
Button text | #000 | The add button's text or icon |
Keep the add button visibly different from the checkout button, which should stay the most noticeable thing in the drawer.
AI-recommended products
With Use AI-recommended products on, Shopify picks the products for each shopper's cart. Choose a Recommendation algorithm:
Algorithm | Where the products come from |
Related (default) | “Shopify suggests products bought with what’s in the cart, with similar descriptions or in the same collections. The preview shows samples.” |
Complementary | “Shopify suggests the complementary products set up in its Search & Discovery app. The preview shows samples.” |
Related works with nothing to set up, and gets better as your store builds up order history. On a new store, its picks lean on descriptions and collections.
Complementary needs setting up in Shopify first. In Shopify's Search & Discovery app, open a product and add its complementary products. With none set up, no upsells show.
The editor's preview shows sample products, not real recommendations. Check your store to see them.
While AI recommendations are on, your rules are hidden but kept. Switch Use AI-recommended products off to see them again.
Your own rules
With Use AI-recommended products off, you decide what's offered with rules. Each rule reads "when this is in the cart, offer this".
Click Add rule. A card named Rule 1 appears (Rule 2 for the next, and so on).
Under When this is in the cart, keep All products to offer the product with any cart, or click it and pick one product. The rule then applies only when that product is in the cart.
Under Offer this, click Select product and pick the product to offer.
Add as many rules as you like. Click Remove on a rule to delete it.
How rules work:
One product on each side. To offer two products with the same trigger, add two rules.
Variants come with the product. You can't pick variants: a rule takes every variant of the product, up to 60. Shoppers choose one from a dropdown on the upsell card.
A rule matches the variants it saved. If you add variants to a product later, open the rule, pick the product again, and publish, so the new variants can trigger the rule and be offered.
Every rule needs a product to offer. A rule left empty stops the cart upsell saving, with “Rule 1: choose the product to offer.” (with the rule's number), even while product upsells are switched off or AI recommendations are on. Remove the rule or finish it.
A rule made in the Atlas app inside Shopify admin can have several products on one side. Atlas Web shows one picker for each, with an × to take a product out while more than one is left.
Choosing a product
Clicking a picker opens a list of your store's products, each with its picture, title and price.
Only active products are listed. Draft and archived products don't appear.
The list shows 10 products at a time. With nothing typed, you see your first 10. Type in Search your products… to find others: a search also shows up to 10 matches, so type more of the name if yours isn't there.
A trigger picker starts the list with All products.
Picking a product closes the list and shows the product's picture and title on the picker.
If the list can't load, you see “Couldn’t load your products. Try again in a moment.” If nothing matches your search, you see “No products match that.”
What shoppers see
The upsells sit under your Upsell title, above or below the cart items, and only once the cart has something in it. They show one product card at a time, in a carousel:
Each card shows the product's picture, title and price, the compare-at price crossed out if you switched that on, a dropdown of variants if the product has them, and the add button.
With two or more products, arrows let shoppers move between the cards, and the carousel loops.
With one product, there are no arrows.
With nothing to offer for this cart, the upsell area doesn't show at all.
The add button adds one of the chosen variant to the cart.
How many upsells shoppers see
The editor has no setting for the number, and Atlas doesn't cap it. Shoppers see one card at a time and can move through all of them with the arrows.
With AI recommendations, Shopify suggests up to 8 products for each item in the cart. Atlas combines them and removes duplicates. For example, a cart with 3 different products can show up to 24 upsells.
With your own rules, every rule whose trigger matches the cart adds its product. A product offered by several rules shows once. The cards aren't in rule order: they're sorted by Shopify's product ID, which usually puts the products you created first in Shopify first.
With Show upsell product if already in cart off, products already in the cart are left out in both cases.
Choosing products that work
Cheaper than what's in the cart. An add-on priced well below the main item is an easy yes.
Few or no choices. Products that need a size or colour picked add a step at the moment the shopper wants to check out.
Obviously related. The shopper should see why it's offered without reading anything.
In stock. An upsell that delays the order is worse than none.
💡 For a single add-on that suits every order, such as a care kit or a gift wrap, use one rule with All products as the trigger. It shows to every shopper, every time.
If upsells don't appear on your store, see Why aren't my upsell products showing in the cart?


