By the end of this you'll have Atlas's cart drawer live on your store, with the features you chose. New to cart upsells? Start with What are cart upsells?. It takes about ten minutes. You need a connected Shopify store: Atlas Web works on the store you connected most recently, and cart upsells are built on its products. Building and saving drafts works on any plan, publishing needs the Scale plan (unless the store has its own plan in the Atlas app inside Shopify admin), and cart upsells use no credits.
In this article:
Step 1: Start a cart upsell from Home
Open Home.
In the row of buttons under the prompt box (after “Start with:”), click Cart upsell.
The box shows a sentence: “Create a cart upsell using template, in English.” A cart upsell is for the whole cart, so Atlas doesn't ask for a product. The language in the sentence doesn't change the cart upsell: its text always starts in English, and you change any of it in the editor.
If no store is connected, the editor shows “Connect your store to make offers” with a Connect store button instead. See How to connect your Shopify store.
Step 2: Pick a template
Click template in the sentence. The templates open on the Cart upsells tab.
Click a template. Its sample shows on the right, headed “Cart upsell · Sample”.
Check the sentence now names it, for example “Create a cart upsell using Upsell drawer, in English.”
Click the round arrow button at the end of the box, or press Enter.
The two templates:
Template | What it starts with switched on |
Upsell drawer (marked Recommended) | Product upsells, using Use AI-recommended products, and Shipping protection |
Reward progress | Reward progress bar, with one reward: free shipping once the cart reaches 100 in your store's currency |
Everything else starts switched off, with Atlas's default text and colours. Start fresh is greyed out and marked Coming soon: it isn't available yet.
ℹ️ The template sample is only an illustration. Its amounts and wording, such as “Free shipping on orders over $75”, aren't what the editor starts with. The editor's preview shows your real settings.
You can also open the templates from the + button in the prompt box (Templates), or by typing / in the box. Picking Upsell drawer or Reward progress from anywhere switches the box to a cart upsell by itself.
The cart upsell editor opens with a new cart upsell named Cart upsell 1, or numbered after your existing ones, for example Cart upsell 3. Nothing is saved yet: it's saved the first time you click Save draft or Publish.
Step 3: Set up the cart drawer
Click the name at the top left and type a name you'll recognise, up to 55 characters. Shoppers never see it.
In the list on the left, click a feature to open its settings.
Switch the feature on with the switch at the top of its settings panel. Each feature shows in the preview as soon as it's on.
Set it up, then click the back arrow at the top of the panel to return to the list.
Click Mobile in the top bar to check the drawer at phone width.
What to set up, and where:
Text, prices and the empty cart: General settings. See Cart drawer text, prices and empty cart settings.
Colours and text sizes: Colors and Text. See Cart drawer colors and text sizes.
Products to offer: Product upsells. See Adding product upsells to the cart.
Shipping protection: see Offering shipping protection in the cart.
Subscription upgrades: see Offering subscription upgrades in the cart.
A message or countdown: Announcement bar. See Setting up the cart announcement bar.
Free shipping or discount goals: Reward progress bar. See Setting up the reward progress bar.
A discount code field: Discount codes. See Letting shoppers use discount codes in the cart.
Payment logos: Payment icons. See Adding payment icons to the cart.
⚠️ If you switch on the reward progress bar, also create the matching automatic discount in your Shopify admin. The bar shows progress, but Shopify gives the reward. Without the discount, shoppers reach the goal and still pay full price.
For a tour of the editor itself, see Navigating the cart upsell editor.
Step 4: Save a draft or publish
Save draft saves your cart upsell without putting it on your store. You see “Draft saved”.
Publish saves it and switches it on for shoppers. You see “Published”.
Publishing switches every other cart upsell on your store off, because the store shows one cart drawer at a time. The editor doesn't warn you about this.
If your plan doesn't include cart upsells, Publish opens Publishing cart upsells needs the Scale plan and saves nothing. Click Upgrade to Scale to see the Scale plans, or Not now, then Save draft to keep your work.
Step 5: Turn on the app embed in your theme
Shoppers only see your cart upsell if the Atlas Cart Upsells app embed is on in your live theme. Publishing doesn't turn it on.
Open Settings → Theme extensions.
Under Theme, pick your live theme, marked (live).
Look at the Cart upsells row (“Display upsell offers in your cart.”). It says On in or Off in, then the theme's name.
If it's off, click Open Shopify theme editor on that row. Shopify's theme editor opens with the app embed added.
Click Save in Shopify's theme editor. Nothing changes on your store until you save there.
Step 6: Test it on your store
The editor's preview uses sample items. Check the real thing:
Open your store in a private browser window.
Add a product to the cart, and check the Atlas cart drawer opens instead of your theme's.
Check each feature you switched on. Product upsells, shipping protection, the announcement bar and the reward progress bar only show once the cart has items.
If you set up rewards, add enough to reach each one, then go to checkout and check the discount or free shipping applies.
If you switched on shipping protection, switch it on in the cart and check it appears at checkout.
Repeat on your phone.
Changes you publish show on your store from the next page load.
Starting from your own words
You can also type a request in the box, such as "Add a cart upsell", without picking a template, and send it. The build chat opens and asks “Which template should the cart upsell use?”, with “Upsell drawer is the one we recommend. You can change everything about it in the editor.” Pick a template. Atlas answers “Setting up a cart upsell with the Upsell drawer template.” (or Reward progress) and opens the editor.
If something goes wrong
The arrow button is greyed out, with “Choose a template to start — pick one of ours.”: click Pick template and choose Upsell drawer or Reward progress.
“Couldn’t read your request.”: click Try again.
“I can build stores, product pages, pre-sell pages, bundles and cart upsells from here. Change your request to one of those.”: your words didn't read as a cart upsell. Change them, or clear them and pick the template.
“This cart upsell couldn’t be opened.”: go back to Offers and open it again.
The cart upsell won't save or publish: see Why won't my cart upsell save or publish?
The drawer doesn't show on your store: see Why isn't my cart drawer showing on my store?

