Skip to main content
This page is the mechanics reference for Upcart Multicart: what happens when you publish a cart, every field you can translate per cart, how per-cart settings and V2 versioning work, how pre-Multicart configurations were migrated, and the current limitations. For how to create, manage, publish, preview, duplicate, delete, and translate carts, see the Multicart guide.

What happens during publishing

Publishing a cart:
  • Syncs the shipping protection product (if configured)
  • Syncs discount combinations
  • Writes all settings to Shopify metafields
  • Marks the cart as LIVE
  • Automatically demotes the previous live cart to DRAFT
This process can take a few seconds.

Translatable fields

You can translate cart-facing text per cart, per Shopify locale, so button labels, headings, and reward messages can differ by language. The following fields can be translated per locale: Header:
  • Cart title
Footer:
  • Checkout button
  • Continue shopping
  • Subtotal label
  • Discount label
  • Discount savings text
Empty cart:
  • Empty cart message
Cart items:
  • Show/hide item labels (singular and plural)
Upsells:
  • Header
  • Add button
  • Review count text
Tiered rewards:
  • Per-tier progress text (up to 6 tiers)
  • Per-tier reward description (up to 6 tiers)
  • Unlock text
Recommendations:
  • Section title
  • Section header
  • “Shop now” button
Notes:
  • Title
  • Placeholder text
Announcement:
  • Banner text
Discount code:
  • Placeholder
  • Button
Subscription upgrades:
  • Button
  • Options text
  • One-time purchase
  • Full price
  • Subscription plan
When you publish a cart, the translations stored for that cart are synced to Shopify’s Translations API, replacing the previous live cart’s translations. Translations for all locales are also copied when you duplicate a cart.

Per-cart settings

Each cart has its own independent configuration.

Shipping protection

Shipping protection is configured per-cart. Each cart has its own shipping protection product configuration. When you publish a different cart, the shipping protection product for that cart is synced, and the previous cart’s shipping protection product is no longer active.

Discounts

Each cart has its own Discounts configuration. You can set up different Discount rules for each cart.
Discounts depend on live cart events and may not behave as expected in sandbox preview mode. Test Discount rules after publishing to a live environment.

Cart versioning (V2)

Upcart has two generations of storefront components:
  • Base (V1) - Older version
  • V2 - Current standard
New carts are created as V2 by default. Only pre-existing carts may still be on V1. When you open the cart editor for a cart that still has V1 modules, you’ll see a banner prompting you to upgrade to V2.0. Each cart tracks its own version state independently, so dismissing the banner on one cart won’t affect other carts. Upgrading updates your cart’s module versions. V2 uses updated storefront components that may render slightly differently. You can revert the upgrade at any time before publishing.

How your previous cart translated to Multicart

If you were using Upcart before this update, here’s how your previous configurations translated:
  • Live cart - Your live cart stayed the same, nothing changed
  • Sandbox - Your saved changes in sandbox are now in a “draft” cart
  • Disabled cart - Your disabled/not-live cart was converted into a draft cart. If your disabled cart had a sandbox version, you now have 2 draft carts in your Carts page

Limitations

  • No hard cap on carts. There is currently no hard limit on the total number of carts. You can create as many draft carts as you need.
  • One live cart at a time. Only one cart can be live at any given moment.
  • Per-cart analytics start March 16, 2026. Analytics from before that date are still available via the analytics page or the chart on the home page.