# Troubleshooting

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

Canonical: https://cartrella.com/docs/bundles/troubleshooting

## 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.
