Check whether your Shopify theme is compatible

Verify app-block support, preview the customer flow, and use Full page when the product template cannot host an embedded customizer reliably.

Composerie works best with an Online Store 2.0 product template that accepts Shopify app blocks. There is no current numerical compatibility score or fixed list of certified theme versions. A short functional test is more reliable.

Check the connected store first

Open Integrations > Shopify and confirm that the intended store is Active and Healthy. Open its details to verify the shop domain before changing a theme.

DashboardA connected store card reading Active, with its shop domain and three stats: orders in the last thirty days, last synced, and Health reading Healthy
Active and Healthy, and the domain under the name. Two stores connected to one workspace look alike until you read that line.

Run a functional theme check

  1. Enable the Composerie app embed and save.
  2. Add the Composerie block to the product template and save.
  3. Publish one test product in Embedded mode.
  4. Complete every required field in a desktop preview.
  5. Repeat at a mobile width.
  6. Confirm variant, price, and add-to-cart behavior.

Run those six steps on the theme you actually sell with. There is no screen in Composerie that scores a theme, and no list of certified versions to look up.

The third one is the dangerous one. An order that arrives without its personalization looks like a normal order.

Use Full page as the fallback

Consider Full page when the template cannot host the embedded form reliably. Verify the storefront button, dedicated page route, required input, and cart handoff. The larger editor reduces dependence on the product layout, but does not certify the theme’s entry and purchase controls.

Is my theme officially supported?

Compatibility depends on the current product template and its standard Shopify app-block behavior, not only on the theme's name.

What if Embedded conflicts with my product form?

Disable the conflicting replacement controls or use Full page mode.

Do I need custom theme code?

Normally no. Use Shopify's app embed and app block. Contact support before adding a theme-specific workaround.

Next

Follow troubleshoot theme placement for a missing or broken live customizer, or page builder compatibility when the product page is built with a page builder rather than a theme section.

Related articles