Skip to main content

Multicart troubleshooting

This guide helps you resolve common issues when working with multiple cart configurations in Upcart.

Preview limitations

Draft previews may not fully reflect live cart behavior. Features that depend on real cart state, live discount codes, or certain integrations may behave differently. Features with known preview limitations:
  • Triggered rewards - May not fire correctly in sandbox mode
  • Shipping protection - Product lookups behave differently in sandbox
  • Express payments (Shop Pay, Apple Pay, etc.) - Not available in preview
⚠️ Tip: For most layout and design changes, the preview is reliable. For testing triggered rewards, shipping protection, or express payments, you’ll need to publish the cart to test properly.

Preview troubleshooting

If you preview a cart and see an incorrect cart, this can happen due to Shopify limitations. Try refreshing the page or opening and closing the cart to refresh the preview.

Troubleshooting translations

If translations aren’t showing on your storefront:
  1. Check if the translation was saved - Go to All Carts → Translate on your live cart and verify text has been entered for the locale
  2. Check if the cart with translations is live - Translations only sync when a cart is published
  3. Check Shopify locale settings - Go to Shopify Admin → Settings → Languages and verify the locale is enabled
  4. Check that the correct locale is active - Your storefront needs to be browsed in the target locale for translations to display

Common issues and solutions

Upcart has disappeared from my store

Most common cause: You have no live cart. How to fix:
  1. Open the Upcart app and go to All Carts
  2. Check whether any cart shows a green “live” badge
  3. If no cart is live, click Publish on any draft cart you want to make active
Other causes:
  • The Upcart Bridge (app embed) may be disabled. The live cart would show a yellow “App embed off” badge. Go to Shopify Admin → Online Store → Themes → Customize → App embeds → enable Upcart Bridge.

My cart settings changed/reset after I published a different cart

This is expected behavior. Publishing a cart overwrites the live Shopify metafields with the new cart’s settings. How to fix:
  1. Your previous cart is still saved as a draft
  2. Go to All Carts, find your old cart in the Drafts section
  3. Click Publish on it to restore the previous settings
How to prevent it in future: Review a draft cart carefully before publishing, since publishing replaces all live settings.

My shipping protection disappeared after switching carts

Shipping protection is configured per-cart. The newly published cart either has no shipping protection product configured, or has a different one. How to fix:
  1. Go to the cart editor for the currently live cart
  2. Navigate to the Add-ons module → Shipping Protection section
  3. Re-configure the shipping protection product
  4. Save (the live cart’s settings will update immediately)
If you want both carts to have the same shipping protection: Configure the shipping protection product on each cart individually before publishing.

My triggered rewards stopped working after switching carts

Triggered rewards are configured per-cart. The newly published cart may not have triggered rewards set up. How to fix:
  1. Open the cart editor for the currently live cart
  2. Navigate to Triggered Rewards in the editor
  3. Verify that the reward rules are configured
  4. If not, re-create them
  5. Save
To restore triggered rewards from your old cart:
  • Re-publish the old cart (which will restore that cart’s triggered rewards), OR
  • Duplicate that cart (which copies its config including triggered rewards), edit as needed, then publish the duplicate

I can’t delete my cart

You’re trying to delete a live cart. Live carts cannot be deleted. How to fix:
  1. Go to All Carts and identify which cart is live (green badge)
  2. Click Unpublish on it
  3. ⚠️ Warning: This will mean no cart is live until you publish another
  4. Once it’s a draft, the delete option will become available
If you have no other cart to publish: Create a new cart (or duplicate the current one), configure it, and then publish the new one before deleting the old one. This avoids a gap with no live cart.

The draft preview doesn’t look right/doesn’t match what I expect

Draft previews use sandbox mode, which has known limitations. Not all features behave the same as in a live environment. Known limitations:
  • Triggered rewards may not fire in sandbox mode
  • Shipping protection may not render correctly
  • Express payment buttons (Shop Pay, Apple Pay, etc.) are not available in preview
For most layout/design changes: The sandbox preview is reliable enough. For testing triggered rewards, shipping protection, or express payments: You’ll need to publish the cart to a live environment to test properly.

My live cart analytics aren’t populated

Per-cart analytics are only tracked from March 16, 2026 onwards. Any analytics from before that date are still stored and available via the analytics page or the chart on the home page.

Frequently asked questions

What happens to my current live cart when I publish a new one?

The previous live cart is automatically moved back to draft. This happens instantly. You’ll see a confirmation modal before this happens.

Can I preview both sandbox and live carts at once?

When switching between sandbox and live previews, Upcart will refresh the page to load the correct data. If you need to preview both versions at once, use a private/incognito window for one of them to avoid forced refreshes.

I published a cart by mistake and now my live settings are wrong. What do I do?

No data is lost. Go to All Carts and find the cart you actually wanted to be live (it will now be in the Drafts section). Click Publish on it to restore it as the live cart.

I’m getting an error when trying to publish/unpublish/delete. What’s wrong?

The server prevents two cart mutations from running at the same time for the same shop. If you clicked quickly twice, or two browser tabs triggered the action simultaneously, the second one will fail. Wait a few seconds and try again. The error is transient. If it persists, refresh the page and try once more.

The upgrade to V2 changed how my cart looks. Can I revert it?

If you haven’t published yet: You can revert the upgrade in the cart editor before publishing. If you already published the V2 cart: If you have your old cart still as a draft (V1), you can re-publish it to restore the V1 appearance.

I don’t see a “Translate” option on my cart. Where is it?

The Translate action only appears in the All Carts table, not on the homepage cart card. It also requires you to have at least one non-English locale enabled in your Shopify store. To access it:
  1. Go to Upcart → All Carts (via “Manage all carts” on the homepage)
  2. Find your cart in the table
  3. Look for the Translate button in the row actions
If no Translate option appears at all, you may not have additional locales set up in Shopify. Go to Shopify Admin → Settings → Languages to add a locale.