Check the app embed first. The Atlas cart drawer runs through the Atlas Cart Upsells app embed in your theme, and publishing a cart upsell doesn't switch it on. While the embed is off in your live theme, your theme's own cart drawer keeps working and the Atlas drawer never appears. In Atlas Web, open Settings → Theme extensions and look at the Cart upsells row.
In this article:
Why it happens
Two things must both be true for shoppers to see the Atlas cart drawer: the Atlas Cart Upsells app embed is on and saved in your live theme, and one of your cart upsells is published. A plan that includes cart upsells (Scale, or your store's own plan in the Atlas app inside Shopify admin) keeps it showing.
Step 1: Check the app embed
In Atlas Web, open Settings → Theme extensions.
Under Theme, pick your live theme, marked (live).
Read the Cart upsells row:
What it says | What to do |
On in and your theme's name | The embed is on. Go to step 2. |
Off in and your theme's name | Click Open Shopify theme editor on that row. Shopify's theme editor opens with the app embed added. Click Save in Shopify. |
“Couldn’t check this theme” | Reload the page and check again. If it keeps happening, check the embed in Shopify (below). |
“Status unavailable · Shopify not connected” | Connect your store first. See How to connect your Shopify store. |
⚠️ Nothing changes on your store until you click Save in Shopify's theme editor. Opening the editor and closing it without saving leaves the embed off.
To check in Shopify instead: in your Shopify admin, go to Online Store → Themes, click Customize on your live theme, open App embeds, and make sure Atlas Cart Upsells is on. Then click Save.
Step 2: Check a cart upsell is live
Open Offers.
If you have bundles too, set Type to Carts.
One cart upsell should be marked Live.
If they're all marked Draft, open the one you want and click Publish. Saving a draft never puts a cart upsell on your store.
If one is Live but your changes don't show, you may have been editing a different cart upsell, which is still a draft. Open the live one, make your changes there, and click Publish.
Step 3: Check you're on the right store
Atlas Web works on the store you connected most recently, and Offers shows that store's cart upsells. If you have several stores, check the one you're testing is the one connected now: Settings → Integrations shows it.
Step 4: Check your plan
Publishing a cart upsell needs the Scale plan, unless the store has its own plan in the Atlas app inside Shopify admin. If your Scale plan has ended, and the store has no plan in the Atlas app inside Shopify admin, shoppers get your theme's own cart drawer instead. Your cart upsell stays in Offers and shows again once you're back on Scale.
Check Settings → Billing & credits. See Plans and credits.
Step 5: Check for another cart app
⚠️ Only one app can own the cart drawer. Another cart drawer, slide cart or cart upsell app conflicts with Atlas's, and whichever loads last usually wins. Switch the other app off and test again.
Apps that replace your theme's add-to-cart, such as some sticky add-to-cart bars or quick-buy apps, can also skip the cart drawer altogether.
Step 6: Test in a private window
Open your store in a private (incognito) browser window, or on your phone using mobile data.
Add a product to the cart.
If you use a speed or caching app on your store, clear its cache.
Published changes show from the next page load, so reload the page after you publish.
If the drawer opens but a feature is missing
The app embed is working. Check the feature itself:
Missing | Check |
Any feature | It's switched on in the live cart upsell: open the feature and look at the switch at the top of its panel. Then click Publish. |
Product upsells, shipping protection, the announcement bar or the reward progress bar | These show only once the cart has something in it. |
The announcement bar | If its text has |
Product upsells | They show only when there's something to offer for that cart. See Why aren't my upsell products showing in the cart? |
Subscription upgrades | They show only for products with a selling plan. See Why aren't subscription upgrades showing in the cart? |
Shipping protection | It works once Atlas has created its product in your store, which happens when you publish with shipping protection on. Check your Shopify Products list for it. |
The free shipping line | It needs Show subtotal line on, and shows only once the cart reaches a Free shipping reward. |
The subtotal | Show subtotal line in General settings must be on. |
If it stopped after a theme change
App embeds are switched on per theme. Publishing a new theme, restoring an older one or installing a theme update can leave Atlas Cart Upsells off, and every part of the Atlas drawer disappears at once with no error. Repeat step 1 for your new live theme.
💡 Before you publish a new theme, turn on Atlas Cart Upsells in it while it's still unpublished: pick it under Theme in Settings → Theme extensions.
If it still isn’t working, open the menu from your profile at the bottom of the sidebar and choose Chat with support, or email support@helloatlas.io.
