Skip to main content

How to enable the Atlas Cart Upsells app embed

Switch on the app embed that makes your Atlas cart drawer appear, and confirm it is active on the theme customers actually see.

Written by Eddie Lavandera

By the end of this the Atlas Cart Upsells app embed will be active on your theme and your cart drawer will appear. It takes under a minute. You need theme editing permission in Shopify.

Until the embed is on, your theme's own cart drawer keeps working and the Atlas drawer never shows, no matter how the drawer is configured.

In this article:


The quickest way, from Atlas

Atlas prompts whenever it notices the embed is off, with the banner:

Atlas Custom Cart Drawer is not enabled on your published theme.

Enable it by clicking the 'Activate' button below and then 'Save' on the following page.

  1. Select Activate.

  2. Shopify's theme editor opens with the embed already switched on.

  3. Select Save in the theme editor.

  4. Return to Atlas and select I have done it.

You can also start from the Theme extensions card on your dashboard, where Atlas Cart Upsells shows Active or Inactive with an Activate button.

⚠️ Pressing Save in the theme editor is what applies the change. Opening the editor turns the toggle on; closing without saving leaves the embed off.


Doing it manually

If the button does not open the right place, or you need a theme other than your published one:

  1. In your Shopify admin, go to Online Store, then Themes.

  2. Select Customize on the theme you want.

  3. Open Theme settings, the gear icon at the top of the left panel.

  4. Select App embeds.

  5. Turn on Atlas Cart Upsells.

  6. Select Save.


Confirming it worked

  1. On your Atlas dashboard, check the Theme extensions card. Atlas Cart Upsells should show Active.

  2. Open your storefront, add a product to the cart, and confirm the Atlas drawer opens rather than your theme's.

The drawer should carry whatever modules you enabled. If it opens but is empty of your modules, the embed is working and the drawer configuration is the thing to check.


Doing this for more than one theme

The embed is per theme. That matters when:

Situation

What to do

You switch to a new theme

Enable the embed on it before publishing the theme

You duplicate a theme to test changes

Confirm the copy has it before you publish the copy

You install a theme update that replaces settings

Re-check afterwards

⚠️ Publishing a theme without the embed silently reverts your store to its native cart drawer. Every upsell, the progress bar and shipping protection disappear at once, with no error anywhere. Enable the embed on the new theme while it is still unpublished.


If the drawer still does not appear

  1. Confirm you saved in the theme editor.

  2. Confirm the right theme. The Theme extensions card reports on your published theme and names it.

  3. Confirm a drawer is active. The embed makes Atlas able to show a drawer; you still need one set to Active. Only one can be active at a time.

  4. Check for another cart app. Only one app can own the cart drawer. Another cart or upsell app will conflict.

  5. Clear caches and test in a private window.

If the embed is on and saved but Atlas still reports it inactive, contact support from the chat bubble in Atlas, or at support@helloatlas.io, with your store URL and theme name.


Next steps

Did this answer your question?