Troubleshooting

#My cart isn't showing on the storefront

Work through these in order — the first two explain almost every case.

1. 1
   Is the Cart Widgets app embed enabled in your live theme?

   Settings → Storefront → Open Theme Editor → App embeds → Cart Widgets. It has to be on and saved *in the theme you have published*. Changing or updating a theme resets this. See Enable Cartie in your theme.

2. 2
   Have you published a cart?

   A cart that only exists as a draft never reaches shoppers. Check that one cart shows as Live in My Carts.

3. 3
   Do you have an active plan?

   Publishing needs a subscription (the 14-day trial counts). If your plan lapsed or an upgrade prompt was left unapproved, the storefront reverts to the default Shopify cart. Check Settings → Billing & Plans.

4. 4
   Are you looking at a cached page?

   Hard-refresh, or open your store in a private window.

#I published, but the storefront still shows the old cart

• Give it a minute — the configuration is served from a CDN and propagates quickly, but not instantly.
• Hard-refresh the storefront (a private window is the reliable test).
• Publish again. Publishes are idempotent; a second one costs nothing.
• Run Settings → Developer → Purge CDN cache to force every storefront to re-fetch.
• Check that Dev mode is switched off on the Cart Widgets block in your theme editor. Dev mode points your storefront at a development CDN, which is the classic cause of "publishing does nothing".

#The drawer doesn't open when I add to cart

• Some themes and third-party add-to-cart or sticky-cart apps intercept the same click. Try disabling other cart-related apps one at a time.
• Check your browser's developer console for errors from your theme's own scripts.
• If your theme uses a custom add-to-cart implementation, contact support with your theme name — we have worked through most of them.

#The cart looks different on my storefront than in the builder

• Your theme's CSS can influence fonts and spacing inside the cart. Set explicit fonts in Cart settings → Appearance rather than relying on *Theme default*.
• Confirm you are comparing like with like — the builder's *Desktop — Full Page* view is the /cart page, not the drawer.

#Shoppers can't add shipping protection

The fee product was probably deleted, unpublished from the Online Store channel, or replaced in Shopify. Reopen the Shipping Protection widget's setup, re-select or recreate the product, and republish. See Shipping protection setup.

#A discount isn't applying at checkout

• Free-shipping bar: it only shows progress. Create the matching free-shipping rate in Shopify → Settings → Shipping and delivery.
• Discount code / Scratch Off: the code must exist as a real discount in your Shopify store, and be active and within its date range.
• Flash sale, rewards ladder, volume discounts: Cartie creates these automatically at publish — republish the cart if you have changed the settings, and check Shopify's discount combination rules if two offers need to stack. See Discounts Cartie creates.

#Upsell products aren't showing

• *Related* source needs Shopify to have recommendations for what is in the cart — new stores and unusual catalogues sometimes have none. Switch to *Manual* and hand-pick products.
• Products must be available in the Online Store sales channel and in stock.

#My analytics look empty or wrong

• Data needs traffic. A quiet store may take a day or two to show meaningful numbers.
• Purchase data comes from Shopify's order webhook and can lag storefront events by a few minutes.
• Widget revenue columns overlap by design — one order can be assisted by several widgets, so they will never sum to your total.
• If revenue is stuck at zero while orders are clearly coming in, contact support: certain Shopify data permissions have to be granted at the account level before order data can flow.

#I can't start an experiment

• Only one cart test runs at a time, and cart tests cannot run alongside widget tests. Pause the other one first.
• Only one widget test per widget.
• Experiments need an active plan and a live cart to test against.

#Still stuck?

Tell us your store domain, what you expected, what happened, and the browser you saw it in — that usually gets a same-day answer.