This guide explains how Composerie reads your Shopify theme, what the compatibility score means, and which themes get extra tuning. It is for merchants who want to know how well the customizer fits their current theme before they go live.
How Composerie reads your theme
Composerie needs to find a few parts of your product page to work: the product form, the variant controls, the image gallery, the price, and the add-to-cart button. It locates these using CSS selectors, the small patterns that point at elements in your page markup.
Composerie reads your theme name first. It checks the shopify-theme meta tag in your page, and the Shopify.theme global as a backup. It then matches that name against a built-in list of 20-plus known Shopify themes.
When your theme is on the list, Composerie uses selectors tuned for that exact theme. Tuned selectors find your variant controls, gallery, price, and add-to-cart button more reliably, so the customizer slots into the right place.
When your theme is not on the list, Composerie uses a broad generic fallback instead. The fallback chains together the standard Shopify selectors that most themes share. It covers product forms, variant selectors, image galleries, price elements, and add-to-cart buttons. So an unrecognized theme still works as long as it uses standard Shopify markup.
The supported list includes Dawn, Debut, Impulse, Prestige, Warehouse, Brooklyn, Minimal, Supply, Venture, Narrative, Sense, Taste, Studio, Refresh, Crave, Colorblock, Ride, Spotlight, Origin, and Express. Dawn and its family (Sense, Taste, Studio, Refresh, Crave, Colorblock, Ride, Origin, and more) are first-class, so if you use one of these you get the best fit.
Read your compatibility score
During onboarding, Composerie checks your live product page and shows a compatibility score from 0 to 100, along with a plain label. The label tells you at a glance how good the fit is.
The score adds points for each thing Composerie finds on the page:
- A standard product form on the page adds the most points.
- Recognizable variant controls, like a dropdown or radio buttons, add more.
- A known theme adds points. An unknown but named theme adds a smaller amount.
- No conflicting custom elements (nothing already claiming the customizer markup) adds points.
- Product data on the page, the JSON that lists variants, adds the rest.
If a medium-compatibility page builder is detected, the score drops by a small amount. For more on that, see page builder compatibility.
The total maps to one of four labels:
- Excellent for a score of 80 or higher.
- Good for 60 to 79.
- Moderate for 40 to 59.
- Limited for below 40.
A lower score does not mean Composerie will not work. It means On-page mode, where the customizer sits inside your product page, may need the Storefront fit settings to line up well. Or you may prefer Full-page mode, which gives the customizer its own page and sidesteps theme layout entirely. See storefront modes explained to compare the two.
My theme is not on the supported list. Will the customizer still work?
Yes, in most cases. Composerie falls back to generic selectors that match standard Shopify markup, which covers product forms, variant controls, galleries, price, and the add-to-cart button. Run the compatibility check to confirm the fit.
I use Dawn but my score is not Excellent. Why?
Check your Dawn version. Tuned Dawn selectors need version 12.0 or newer. On an older version, Composerie uses the generic fallback. The score can also drop if a page builder is detected or if the product page is missing variant controls or product JSON.
What is a conflicting custom element?
It is markup on the page that already looks like a customizer, such as another product personalization app. When Composerie sees one, it cannot be sure it owns the right element, so the score is reduced.
Does a Limited score mean I cannot sell personalized products?
No. A Limited score points you toward Full-page mode or the Storefront fit settings rather than On-page mode. You can still sell personalized products either way.
If your score is lower than you expected and the customizer is not landing where you want, see troubleshoot theme placement. If you get stuck, contact support.
Next
Once the fit looks right, learn how the customizer slots into your page with the customizer theme block.