Cart page offers or cart drawer offers?
Appfox adds two items to the theme editor, one for each place a shopper can see their cart:
If your theme has both a cart page and a drawer, turn on both. Cart drawer offers is drawer-only: on the cart page (
/cart) it does not render, even when the offer API returns a bundle. Add Cart page offers for that page. Cart drawer offers also powers cart rewards.
What is the cart upsell banner?
The cart upsell banner is an optional app block that displays on your cart page. When a customer has products in their cart that are part of a bundle, the banner suggests adding the remaining products to receive the bundle discount. Example: Customer adds a phone to their cart. The banner shows: “Add a phone case and screen protector to save 20% on your purchase!”Adding the cart banner
1
Open the theme editor
Go to Online Store → Themes in your Shopify admin, click Customize on your active theme.
2
Navigate to the cart page
In the theme editor, use the page selector at the top to navigate to the cart page template.
3
Add the app block
Click Add block, scroll to the Apps section, and select Cart page offers. On Horizon, add it to the Cart section (not a nested cart-items or summary block). The block is also available in the header and aside groups so you can place it in a cart drawer.
4
Position the banner
Drag the banner block to your desired position. Common placements:
- Above the cart items list
- Below the cart items, above checkout button
- In the cart sidebar
5
Save your changes
Click Save in the top right corner.
For cart drawers (Horizon, Dawn, and similar themes)
1
Enable the app embed
In the theme editor, navigate to Theme settings → App embeds (left sidebar).
2
Find and enable the upsell embed
Locate Cart drawer offers in the list and toggle it on.
3
Save your changes
Click Save in the top right corner.
The app embed injects the banner into Horizon’s cart drawer and Dawn’s cart drawer. Turning the embed on is not enough on its own: you also need an active bundle that includes a product already in the cart and at least one product still to add. If nothing matches, the drawer stays empty.
Banner behavior

When the banner appears
The banner displays when:- Customer has at least one product from a bundle in their cart
- The customer hasn’t added all products required for the bundle
- Bundle is active and products have inventory
Multiple bundle opportunities
If cart products are part of multiple bundles:- Banner shows the single highest-value opportunity. Offers whose products are already in the cart and offers with a sold-out product are skipped
- Each opportunity displays potential savings
- Bundles are sorted by highest savings first
What the banner shows
- Bundle name
- Products already in cart (marked with checkmark)
- Products still needed with variant pickers
- Potential savings amount
- One-click “Add all to cart” button with savings amount
Technical details
- Uses Shopify’s section rendering for instant cart updates (no page reload)
- Automatically adds bundle properties for discount application
- Classic bundles use
_appfox_classic_bundle_idattribute for proper discount function handling - Dismissible per session (banner returns on new session)
Before you check out offer
You can also show one offer when a shopper clicks the regular Checkout button on the cart page or in the cart drawer.1
Enable the app embed
Enable Cart drawer offers under your theme’s App embeds. The Cart page offers block also loads the popup on the cart page.
2
Enable your checkout offer
In the app, open Settings → Checkout offer and turn on Enable checkout offer.
3
Choose the trigger
Set Show when to a minimum cart value or to a cart containing any of your selected trigger products. For a value trigger, set Cart value currency to the shopper’s three-letter cart currency. Other currencies skip this offer.
4
Choose the offer
Choose Products and select up to 10 products with variants and quantities, or choose an active Classic or Fixed bundle with 1 to 10 component products. Accept adds only the units that are not already in the cart. Items already in the cart count toward the bundle, so the bundle discount can apply without a second copy of each product. Units that already belong to a different bundle stay on that bundle, and this offer adds its own copy of those units. Subscription items stay on their selling plan and do not count, so accept adds one-time units for the offer. The bundle’s schedule, customer targeting and automatic discount rules still apply. Other bundle types are not selectable here.
5
Add an optional discount code
Optionally enter a Shopify discount code (optional) that you already created in Shopify Discounts. Shopify controls its eligible products, combinations, usage limits and expiry. Configure those rules in Shopify; this setting does not create a discount or guarantee that it applies to every cart.
6
Set an optional countdown
Optionally set Offer countdown (seconds), from 1 to 900. Use 0 for no countdown. When the countdown ends, checkout continues. The countdown closes the offer; it does not change your discount code’s Shopify expiry.
7
Save your offer
Click Save in the save bar.
Shop Pay, Apple Pay, Google Pay, PayPal and other accelerated checkout buttons bypass the popup. Standard checkout links and cart form buttons are supported; custom theme controls that do not expose a standard checkout link or a cart form button named
checkout may bypass it too. If the app script or settings fail to load, checkout keeps working. Offer preparation waits at most 1.6 seconds before continuing.Banner settings
Block settings (in theme editor)
Configure in the theme editor:- Position: Drag to place above or below cart items
- The banner inherits your bundle widget styling automatically
Style settings (in Product Bundles app)
The cart banner uses your existing bundle widget styles from Settings → Design:- Colors automatically match your widget design
- The Complete the bundle and save pill uses the badge background and badge text
- The check mark on a product already in the cart, and the border around that product, use the accent colour
- Fonts and button styles sync with product page widgets
- Border radius follows your widget configuration
.cart-upsell-savings, .cart-upsell-check-icon, and .cart-upsell-product.in-cart.
Customizing the banner
Messaging
Customize the banner message to match your brand voice:- Urgent: “Don’t miss out! Complete your bundle and save 20%”
- Helpful: “You might also like these items. Buy together and save!”
- Value-focused: “Save $15 by adding these products to your cart”
- Casual: “Looking good! Add these to complete the bundle”
Visual style
Match your cart page design:- Use colors that stand out but don’t clash
- Choose a layout that fits your cart page structure
- Ensure the banner is noticeable but not annoying
Timing and dismissal
- Always show: Banner appears every time conditions are met
- Dismissible: Customers can close the banner (won’t show again in same session)
- Session-based: Reset dismissed state after customer leaves and returns
Banner effectiveness
Why cart banners work
- Timely: Customers are already in buying mode
- Relevant: Shows bundles for products they’ve already chosen
- Low friction: One click to add remaining products
- Clear value: Savings amount is prominent
Conversion tips
To maximize cart banner conversion:- Show savings first: Lead with “Save $X” or “X% off”
- Keep it simple: Don’t overwhelm with too many products
- Use urgency carefully: “Complete your bundle now” without being pushy
- Visual product previews: Show images of products to add
- One-click add: Make it as easy as possible to add products
Best practices
Don't be too aggressive
Don't be too aggressive
The cart banner should suggest, not demand. Give customers the option to dismiss it if they’re not interested.
Prioritize high-value bundles
Prioritize high-value bundles
If multiple bundles apply, show the one with the highest potential savings or best conversion rate first.
Keep messaging clear
Keep messaging clear
Explain exactly what the customer needs to do: “Add [product] and [product] to save 20%”.
Test different positions
Test different positions
Try the banner above cart items, below them, or in the sidebar. Track which position converts best.
Match cart page style
Match cart page style
The banner should feel integrated into your cart page, not like an intrusive popup.
Show product images
Show product images
Visual previews of products to add increase click-through rates compared to text-only suggestions.
Cart banner vs. product page widget
Both work together to maximize bundle conversions:
Use both: Product page widget introduces bundles; cart banner reminds customers who didn’t use the widget.
Examples
Fashion store
Cart contents: 1 dress Banner: “Complete your look! Add matching shoes and handbag for 20% off. Save $30” [Add to cart button]Electronics store
Cart contents: 1 laptop Banner: “Protect your purchase. Add a case and screen protector for $15 off.” [Quick add buttons]Beauty store
Cart contents: Cleanser, toner Banner: “You’re so close! Add moisturizer to complete your skincare routine and save 25%.” [Add button]Tracking performance
Monitor cart banner effectiveness in the Analytics page:- Banner views: How often the banner is shown
- Add clicks: How many times customers click “Add all to cart”
- Conversions: Completed bundle adds from cart upsell
- Average savings: Average discount amount offered
- Conversion rate: Percentage of views that result in adds
Troubleshooting
Banner not appearing:- Verify cart page app block is added in theme editor
- For cart drawers: Enable the Cart drawer offers app embed in Theme settings → App embeds
- Create and activate a bundle that includes both the product in the cart and at least one product still to add (Classic, Fixed, or Mix & Match). A single-product volume discount will not show an upsell
- Check that cart products are part of those active bundles
- Ensure the shopper hasn’t already added every product in the bundle
- Confirm the bundle is within its schedule and the shopper matches any customer targeting
- Confirm app is installed and bundles are active
- Check bundle product configuration
- Verify cart products match bundle requirements
- Banner prioritizes bundles with highest potential savings
- Check browser console for JavaScript errors
- Ensure theme supports section rendering
- Try refreshing the page
- The banner auto-hides after successful add
- Verify app embed is enabled in theme settings
- Horizon and Dawn are fully supported; custom themes may need theme developer assistance
- Cart drawer offers does not render on the cart page. Add the Cart page offers block to the cart template
- Check if the cart drawer dispatches
shopify:cart:lines-update/cart:update(Horizon),cart:updated(Dawn), or PubSubcart-update