Theme Integration Setup (Theme cart + Ego features)
Keep your theme's own cart and show Ego's reward bar, free gifts and upsells inside it.
1. Overview
Ego Cart works in two modes. You can switch between them at any time.
Ego cart drawer (Recommended) | Theme cart + Ego features | |
|---|---|---|
What shoppers see | Ego's fully customizable drawer replaces your theme's cart on every page. | Your theme's own cart drawer and cart page, with Ego features inside. |
Reward bar, free gifts, upsells | Yes | Yes |
Announcements, add-ons, trust badges | Yes | No |
Express checkout, sticky cart | Yes | No |
Design | Fully customizable | Keeps your theme's look |

Choose Theme cart + Ego features if you love your theme's cart and only want to add Ego's sales boosters to it.
2. Supported themes
Ego detects your live theme automatically. On these themes, features work in both the cart drawer and the cart page:
Horizon and its family: Atelier, Pitch, Fabric, Dwell, Heritage, Ritual, Savor, Tinker, Vessel.
Dawn and Shopify's free themes based on it: Refresh, Sense, Craft, Studio, Taste, Origin, Crave, Colorblock, Ride, Spotlight, Publisher, Trade.
Impulse, Prestige and Impact.
Contact our support team if you are using an unsupported theme.
3. Configuration steps
Step 1: Switch to Theme cart mode
By default, you will start with the original Ego Cart Drawer. Before you switch, make sure you have an Active cart in the Cart Editor with the Reward bar, Free gifts or Upsells turned on. Follow the below steps to switch the the theme cart mode:
From the app's navigation menu, go to Theme integration.
In Your theme, check that Ego detected your live theme and its cart type (Drawer, Page or Notification). If you just changed themes, click Re-scan.

In Cart mode, select Theme cart + Ego features and confirm with Switch to theme cart.

Step 2: Choose where Ego features appear
In the Placement card, set the position of each feature (Reward bar, Free gifts, Upsells) separately for the Cart drawer and the Cart page: Top - below the cart title; Bottom - above the subtotal and checkout button; Hidden - not shown on that surface.

By default, the Reward bar is at the Top, and Free gifts and Upsells are at the Bottom. Features in the same position always show in this order: Reward bar, Free gifts, Upsells. (eg. if Free gifts and Upsells are both set up to display at the bottom of the cart page, Free gifts section is always above the Upsells.)
Custom position is available for Cart Page. To customize, you can hover on the tooltip next to "Cart page" and navigate to Theme Editor > Add Ego Cart's block to the preferred placement. Added block overrides the chosen position in this Placement card.
The Advanced (for support) section contains custom position settings. Only change it if Ego support asks you to.


Step 3: Match the theme
In the Appearance card, keep Match my theme's font on so Ego features use your theme's font. Colors and styles are set in the cart editor.
Click Save when you're done.
4. Troubleshooting
My add-ons don't show
Check that the App embed status is Active.
Make sure you have an Active cart with the Reward bar, Free gifts or Upsells turned on, and that its display conditions match you.
Add a product to the cart — add-ons don't show in an empty cart.
Check the add-on isn't set to Hidden in the Placement card.
Add-ons only show on the cart page
Your theme's cart drawer may not be supported yet (badge Cart page only). Contact support, or switch back to the Ego cart drawer.
If your theme's cart type is Notification (a small popup after add to cart), add-ons show on the cart page only. For the best results, change your theme's cart type to Drawer — click Open theme settings in the Your theme card.
Ego shows the wrong theme
Click Re-scan in the Your theme card. Ego also re-detects your theme automatically when you publish a new one.
Free gifts don't show
Free gifts aren't included in the Free plan. Upgrade your plan to use them in your theme's cart.
Need help? Let us know via in-app live chat or email: help@egohub.co 🤩
Still need help?
Our support team is available 24/7. Contact support →
