Something not working the way you expect? This guide covers the problems Composerie merchants run into most, with the fastest fix for each. It is written for anyone setting up or running a store, no technical background needed. Work through the quick checks first. Most issues clear up in under a minute.
Run these quick checks first
Before you dig into a specific problem, run through this short list. These checks resolve the majority of reports we see.
Hard refresh the page
Hold Shift and click the browser reload button. A normal refresh can leave an old script or cached state in place. A hard refresh clears it and loads the current version. Try your product page again after the reload.
Check your browser is current
Composerie supports recent versions of Chrome, Safari, Firefox, and Edge. An out-of-date browser can break the customizer in ways that look like a bug. Update your browser, or try the page in a different one to rule it out. For the full list, see browser and device support.
Confirm the app is installed and the product is published
Open your Shopify admin and go to Apps. Composerie should appear in the list and be active. Then open the product itself and confirm it is published to your online store. A draft product, or a missing app, will not show a customizer.
If you just edited a template, wait about a minute
The storefront caches the variant-to-design mapping for 60 seconds. If you changed a design or template in the dashboard, give it up to a minute, then hard refresh the storefront. Your change appears once the cache expires.
Frequently asked questions
Here are the four questions we hear most. Each one links to a dedicated article with the full fix.
Why is the customizer not showing on my product page?
The most common cause is a product left on the default linked mode, which renders nothing on the storefront by design. Other causes are an unpublished product, the theme block being off, or a browser cache. See the customizer not appearing article for the full checklist.
I edited a design but my change is not showing on the storefront. Why?
The storefront caches the variant-to-design mapping for 60 seconds. Wait about a minute, then hold Shift and click reload to hard refresh. See the changes not showing article if it still does not update.
A customer says they cannot add a personalized product to the cart. What now?
This is usually a variant or mapping issue, or a theme conflict with the add-to-cart button. See the product will not add to cart article for the step-by-step fix.
An order came in but it did not reach my print provider. What happened?
Personalization is carried through the order, not a storefront form, so the order routes to your provider after checkout. Check your provider connection and the order status. See the error messages article for what each message means.
For deeper help on any of these, open the matching guide: customizer not appearing, changes not showing, product will not add to cart, and error messages explained.
Still stuck
If the quick checks and the FAQ did not solve it, gather a few details before you reach out. Having these ready means we can help you faster.
- The exact steps you took, in order, and what you expected to happen.
- The specific product or order, with its name or ID.
- Any error text you saw, copied word for word.
If you saw a message you do not recognize, check error messages explained first. It covers what each one means and how to clear it. When you are ready, head to contact support and include the details above.
Next
Start with the issue closest to yours: the customizer is not appearing.