What Are Discount Upsells?
Discount Upsells are smart notifications that:- Tell shoppers how close they are to a reward (like a discount or free shipping)
- Suggest exactly what to add or spend to qualify
- Highlight relevant products to help them reach the goal
Use This When
You want to show spend-to-qualify or add-one-more messages for product discounts, order discounts, or free shipping
Related Setup
Review Fulfillment Type Exclusions and Checkout Extension Setup if your shipping offers depend on fulfillment rules
How It Works
Every promotion you create in Atom Commerce can be configured to show upsell messages when a customer is close to qualifying. These messages are tailored to the type of promotion:1. Product Discounts (Buy X, Get Y, Volume, etc.)
When a shopper is just short of a product-based deal, they’ll see a message like:Add 1 more to save USD X!Example:
- Promotion: “Buy 3, get 1 free” on light bulbs
- Cart: Customer has 2 boxes
- Upsell: “Buy one more box of light bulbs and get the next one free!”
2. Order Discounts (Spend Thresholds)
For order-wide discounts, Atom Commerce will show:Spend USD 25 more to get 10% off your orderExample:
- Promotion: “10% off orders over USD 100”
- Cart: USD 75 subtotal
- Upsell: “Spend USD 25 more to qualify for 10% off your order!”
3. Shipping Upsells (Free Shipping Bars)
For free shipping promotions, you can display a dynamic bar or message:Spend USD 100 more for FREE DELIVERYExample:
- Promotion: “Free shipping on orders over USD 2500”
- Cart: USD 2400 subtotal
- Upsell: “Spend another USD 100 to qualify for free shipping. Check out our Brand X windbreakers!”
Free Shipping Banners with Exclusions
When a free shipping offer includes exclusions, the banner should be interpreted against the eligible portion of the cart, not just the visible cart total. That means:- excluded products may not count toward the amount needed to unlock free shipping
- excluded fulfillment methods can prevent the free shipping offer from applying even when the spend threshold appears to be met
- the “remaining spend” message should reflect what is still needed in eligible products for an allowed fulfillment method
Merchant Example
Offer setup:- Free shipping over USD 100
- Gift cards excluded from qualification
- Pickup in Store excluded
- USD 40 t-shirt
- USD 50 hoodie
- USD 30 gift card
- visible cart total = USD 120
- eligible subtotal for free shipping = USD 90
- banner should still show the customer is USD 10 away from free shipping
- if the shopper adds USD 10 of eligible merchandise and selects standard shipping, the offer qualifies
- if the shopper chooses Pickup in Store, the free shipping discount still does not apply because that fulfillment method is excluded
How It Behaves
- free shipping upsells should guide shoppers based on the qualifying subtotal
- excluded items can change the banner target even when cart total looks high enough
- excluded fulfillment methods can block the discount after the shopper has otherwise qualified
Common Pitfall
Merchants often assume the free shipping bar is based on the entire cart subtotal. If your offer excludes products or fulfillment methods, the relevant threshold is the eligible cart value for that shipping offer, not the raw cart total.Why Use Discount Upsells?
- Increase Average Order Value: Shoppers are more likely to add items when they see a clear, achievable reward.
- Reduce Cart Abandonment: Customers know exactly what’s needed to unlock a deal, so they’re less likely to leave.
- Personalized Experience: Upsell messages are tailored to each shopper’s cart and your active promotions.
- No Coding Required: All logic is handled by Atom Commerce—just configure your promotions and enable upsells.
How to Enable Upsells
- Create or Edit a Promotion in Atom Commerce.
- Enable Discount Upsells (closeness qualifiers) for that promotion.
- Customize Your Message (optional):
- Use default messages, or
- Add your own text and product suggestions
- Publish and Go Live!
Real-World Examples
- Buy X Get Y: “Add 1 more box of gloves to get the next one free!”
- Order Discount: “Spend USD 50 more to unlock 20% off your order.”
- Free Shipping: “Spend USD 100 more for free delivery. See our USD 100+ jackets!”

