Live Widget Display
Introduction
This page answers the question "where will my widget appear at each touchpoint?"
- Popup on ATC & Cart Drawer: Each touchpoint has fixed slots — predefined positions for widgets. Merchants don't choose the slot; the system places each widget into the slot that matches its widget type.
- Checkout, Thank You: Merchants choose where to place the app block that displays the widget on the page.
How Merchants Do It
For Popup on ATC and Cart Drawer, merchants add widgets to the correct touchpoint on the canvas and publish the funnel. For Checkout and Thank You, merchants place the corresponding app block.
Popup on ATC — 2 slots
| Slot | Position | Widget |
|---|---|---|
| Banner | Strip directly below the popup header | Tiered Rewards Bar, Free Shipping Bar |
| Body | Middle section of the popup, above the footer | Complementary Products |
The popup only opens when at least one widget qualifies for the product that was just added. If no widget qualifies, the buyer continues as they would with the standard theme behavior.
Cart Drawer — 6 slots
| Slot | Position | Widget |
|---|---|---|
| Above items | Above the product list | Tiered Rewards Bar, Free Shipping Bar |
| Within each line item | Below the content of each product line | Subscription |
| Below items | Below the product list | Complementary Products |
| End of cart body | Bottom of the scrollable area | Add-ons (Shipping Insurance, Priority Processing) |
| Above footer | Top of the checkout block | (Add-ons Checkout+) |
| Below checkout button | Below the Checkout button | Payment Guarantee |
Checkout and Thank You
- The widget appears at the app block position the merchant places in Shopify's checkout editor (one block per widget, with the Widget ID pasted in).
- Subscription on Checkout appears automatically below each product line item in the order summary and does not require an app block.
- Checkout and Thank You require the store to be on Shopify Plus.
Post-purchase
- A dedicated Shopify page that opens after checkout and before the Thank You page. GemUpsells must be selected as the post-purchase app.
- Each order displays only one offer page.
Rules to Know
- If the app embed is disabled, Popup on ATC and Cart Drawer don't run, and widgets at these two touchpoints don't appear.
- Cart Drawer only replaces the theme's cart on supported themes. On other themes, the theme's own cart remains and Cart Drawer widgets don't appear. Popup on ATC runs on every theme.
- Supported themes: Dawn and Shopify's free OS 2.0 theme family (Trade, Refresh, Craft, Sense, Studio, Origin, Colorblock, Taste, Ride, Spotlight, Crave, Publisher), Horizon / Tinker / Savor / Dwell, Atelier, Champion, Stiletto, Sahara, Pursuit, Xclusive, Volt, Rise, Turbo, Debutify, Be Yours, Vision, Aurora, Radiance, Eurus, Wonder, Creative, Flawless, Highlight, Showtime, Warehouse, Minimog, Ella, Impulse, Motion, Streamline, Expanse, Prestige, Impact, Focal, Symmetry, Palo Alto, Broadcast, Pipeline, Concept, Sleek, Shapes, Krank, and the vintage themes Debut / Brooklyn / Narrative / Venture / Simple / Minimal / Supply.
- A widget hides itself when it has nothing left to show: the product is out of stock, already in the cart or order (if that hide option is enabled), Smart suggestion returns no recommendation, or a Tiered Rewards Bar has no funnel discount tiers attached.
- Prices follow the store's default currency.
Frequently Asked Questions
Q1. Cart Drawer widgets don't appear, and opening the cart still shows the theme's cart.
The theme isn't on the supported list, the GemUpsells Cart Drawer hasn't been published, or the app embed is disabled.
Q2. The popup doesn't open when clicking Add to cart.
No widget on Popup on ATC matches the display condition for the product that was just added, or the app embed is disabled.
Q3. I want to move Complementary Products above the product list in the drawer.
Not currently supported.
Current Limitations
- Merchants cannot choose or change slots on Popup on ATC and Cart Drawer.
- Cart Drawer only runs on the themes in the supported list.