CartrellaDocs
Bundles

Troubleshooting

The block, the proxy path, and other sharp edges.

View as Markdown

The block shows its heading but no options

The block couldn't reach the configuration endpoint. Almost always the app proxy path: if another app owned /apps/cartrella when Cartrella was installed, Shopify assigned a suffixed path (e.g. /apps/cartrella-1). Set it in the block's App proxy path setting, save, and reload.

Two Cartrella blocks appear in the theme editor

You have more than one Cartrella app installed (e.g. a development install). Uninstall the one you don't use so only one set of blocks appears.

The pack price didn't change after an edit

Editing a live pack republishes automatically; give it a few seconds and hard-refresh. If the pack is a draft, publish it — drafts never touch the storefront.

Checkout shows the pack, not the components

The expansion runs inside Shopify checkout. If it isn't applying:

  • the pack must be Live in Cartrella (not draft),
  • the store must have completed the latest app update (reopen the Cartrella admin — it re-syncs on load actions),
  • development preview links (*.shopifypreview.com) disable checkout entirely; test on the real store domain.

A component sold out but the pack is still buyable

Cartrella takes packs off the storefront automatically when a component sells out (and restores them on restock) — this runs off Shopify's product-update events, so allow a few seconds. If a pack stays visible: adopted products are never auto-hidden (that's yours to manage), and components with "Continue selling when out of stock" enabled count as available on purpose.

Last updated on

On this page