Skip to main content
The cart upsell banner appears on your cart page when customers add products that are part of bundles. It prompts them to complete the bundle to get the discount.

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
On the cart page, the banner automatically moves next to your cart items, above the subtotal, at full content width, so it stays above the fold even if the block sits lower in the template.
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.
In the cart drawer the banner shows one offer as a compact card: one row per product, with long product names shortened to two lines. It has a height limit so the discount summary and Check out button stay in view. Shoppers can hide the offer with the Dismiss link in the card’s top-right corner. Prices use your store’s currency formatting, including thousands separators. For example, a price of 50000 displays as 50,000.00 when your store uses comma thousands separators and two decimal places.
Cart upsell banner offering Red Gloves beside Blue Snowboard already in the cart

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
If the customer has all products from a bundle (and discount will be applied), the banner doesn’t appear. The drawer banner loads when the shopper opens or updates the cart. On the cart page, your banner loads as soon as the page opens.

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_id attribute 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.
The popup shows each product’s image, variant and price, and the offer total. A Save badge and a struck-through original price appear when the bundle has one discount checkout can apply, or when a product’s compare-at price is higher than its price. A bundle with more than one discount offer shows catalog prices. If the cart already carries a running A/B test variant, the badge uses that variant’s discount. Buttons, badges, colors, corner radius and font follow your Design settings. On small screens it appears as a bottom sheet. Shoppers can choose Add offer and check out or No thanks, check out. The close (×) button and clicking outside the popup decline the offer and continue to checkout. Pressing Escape closes the popup and leaves the shopper on the cart; the next checkout click continues without showing the offer again. The popup is shown at most once per browser tab session. If browser session storage is unavailable, it is skipped. Offers use live variant prices and availability; an unavailable product skips the popup. Accept adds only missing units. Units already on a different bundle stay there and do not count toward this offer. Subscription items stay on their selling plan and do not count. Accept marks only the units this offer needs. When a cart line has more units than that, the extra units stay on the line unmarked. It applies the optional code alongside existing codes, and continues checkout. If adding fails, times out, or marking the cart runs long, checkout continues without retrying. If some units were added and the rest of the kit cannot be marked, those added units are taken back off the cart before checkout continues. Units that were already in the cart stay, even when the new units merged onto that line.
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.
See Analytics → Checkout offers for views, accepted offers, declines, countdown expirations and add failures in your selected date range. Accepted means items were added to the cart before checkout, not that an order was placed.

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
Custom CSS from Settings is applied on the cart page and in the cart drawer, the same way it is on the product page widget. It can restyle .cart-upsell-savings, .cart-upsell-check-icon, and .cart-upsell-product.in-cart.
Keep your cart banner and product page widget visually consistent by using the same styling configuration!

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
Choose based on how aggressive you want upselling to be.

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:
  1. Show savings first: Lead with “Save $X” or “X% off”
  2. Keep it simple: Don’t overwhelm with too many products
  3. Use urgency carefully: “Complete your bundle now” without being pushy
  4. Visual product previews: Show images of products to add
  5. One-click add: Make it as easy as possible to add products

Best practices

The cart banner should suggest, not demand. Give customers the option to dismiss it if they’re not interested.
If multiple bundles apply, show the one with the highest potential savings or best conversion rate first.
Explain exactly what the customer needs to do: “Add [product] and [product] to save 20%”.
Try the banner above cart items, below them, or in the sidebar. Track which position converts best.
The banner should feel integrated into your cart page, not like an intrusive popup.
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
The cart banner tracks all interactions through PostHog for detailed analysis. Access these metrics alongside your product page widget performance on the Analytics page.

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
Banner shows wrong bundle:
  • Check bundle product configuration
  • Verify cart products match bundle requirements
  • Banner prioritizes bundles with highest potential savings
Banner not updating after adding products:
  • Check browser console for JavaScript errors
  • Ensure theme supports section rendering
  • Try refreshing the page
  • The banner auto-hides after successful add
Cart drawer not showing banner:
  • 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 PubSub cart-update
The cart banner works best with Shopify 2.0 themes. For older themes, the cart page block is recommended over the drawer embed.
The cart banner is particularly effective for bundles where customers might not notice the product page widget. It gives you a second chance to present the bundle offer at a high-intent moment.