Work top to bottom — the first three cover most cases.
Tip: the Preview button on the Products page renders the real configurator inside the app, without touching your storefront. If it looks right in Preview but wrong on your store, the problem is in your theme (usually the app block); if it's wrong in Preview too, it's in your template or prices.
The configurator doesn't appear on my product page
- Is the app block in your theme? This is the cause 9 times out of 10. On the Home screen, use Open theme editor on the setup step — if the Custom Product Options block isn't placed on your product template, add it and click Save.
- Is the product connected? Check the Products page — the product must be linked to a template.
- Did you publish a different theme recently? The block must be added to the currently published theme.
I changed prices but the storefront still shows old ones
You're probably looking at an unpublished draft. Open the template's Pricing tab — if there's a yellow "These prices aren't live yet" banner, click Publish. (The Home screen also warns you when any template has unpublished changes.)
The price shows $0 or doesn't update
- Make sure a price version is published (Pricing tab shows a green Live badge).
- Make sure your first rule is a Flat charge base price.
- If only certain combinations are wrong, use the test panel with those exact selections — the breakdown shows which rule is (or isn't) firing.
"Add to cart" is greyed out
A validation rule is blocking — the message appears near the price (e.g. "Minimum width is 30 cm"). If shoppers hit blocks you didn't intend, review the validation rules in the Pricing tab.
An option or choice is greyed out for shoppers
A visibility rule disabled it — hover the choice to see the reason. Review rules in the template's Visibility tab.
The configurator prices correctly but the product page price doesn't change
The app could not find your theme's price element. It guesses using the names the common themes use, and on a theme that names it differently the guess misses without erroring.
Fix it under Settings → Storefront theme bindings → Current price: untick Use default and paste the selector for your theme's price. Right-click the price on your product page → Inspect → read the class off the highlighted tag. See Adding the configurator to your theme.
Your browser console will also say so, and list everything it tried.
Card swatches aren't showing on collection pages
In order of likelihood:
- The Cart & collection setup app embed is not enabled (theme editor → App embeds). It is the same embed everything else uses.
- Card swatches is switched off for that product's option set — open the set and scroll to Card swatches.
- The option you pointed at has no colours or pictures on its answers.
- You are looking at the product's own page. Swatches deliberately do not draw there; the real option is right below.
If you see +2 with no swatches before it, the row is being drawn and your theme's CSS is collapsing it. The console says so with the measured size.
My work disappeared when I uploaded an image
This was a bug and it is fixed. If you see anything like it, the console will usually say what happened — contact support with what you were doing.
The configured price didn't reach checkout
Check the Home screen: the Checkout connection step should show Done. If it shows "To do", open Settings to re-sync it. This is set up automatically at install and very rarely needs attention.
The configurator looks off / clashes with my theme
Open Design and adjust the theme assigned to that product — colors, fonts, spacing and tooltip style are all adjustable. On dark storefronts, set Tooltip style to Dark.
My order emails don't show what the shopper configured
This is Shopify's default templates, not a fault. The customer Order confirmation only lists line properties for gift cards, and the staff New order email has no properties loop at all — so neither shows the selections on a configured product.
Configured details in your emails has the exact change for each. On the customer template it is widening one condition that is already there.
A customer's email shows _sig or _price
Unlikely on a current template — the filter that excludes underscore-prefixed properties is already in Shopify's own loop, and the cart, checkout and order status page hide them regardless. If you see one, that template has been customised and lost the filter: same article, same one line of Liquid.
Something else?
Open a ticket in Support — include the product link and a screenshot, and we usually reply within one business day.