Supported browsers and devices

Which browsers and devices work with Composerie, why very old browsers break the canvas, and what a shopper should switch to.

This guide tells you which browsers and devices the Composerie customizer runs on. It is for any merchant whose shopper reports a broken or missing customizer, and who wants to rule out the browser before digging deeper. Record the browser version and device when reporting an issue.

Supported browsers

Use a current version of Chrome, Safari, Firefox, or Edge. Check your published product on the browsers and devices your shoppers use.

The customizer is not a plain web page. It uses modern browser features called Web Components and Shadow DOM, and it draws every design on a live canvas inside the page. Those features need an up-to-date browser. A very old browser cannot run the canvas, so the customizer can look broken, fail to load, or freeze.

If a shopper hits a problem, the first fix is the browser. Ask them to update to the latest version, or open the product in one of the four supported browsers instead. If the problem persists, keep the result for your support report.

For a full list of fast first checks, see common issues and quick fixes.

Phones and tablets

The customizer adapts its layout for phones and tablets. Shoppers use the fields and image tools made available for that product; a responsive layout does not imply that every design element can be dragged or resized.

The customizer uses the store’s resolved appearance settings. Check those settings and the published page when diagnosing colors; do not assume that appearance always follows the device’s light or dark mode.

One detail worth knowing: the storefront-fit layout tools (the toggles that widen the customizer column on a tight theme) apply on desktop only. Mobile is left untouched, because phone layouts already give the customizer the full width it needs.

StorefrontThe customizer running on a phone with touch controls
Check the configured fields and store appearance on the shopper's device.
StorefrontComposerie customizer on a desktop storefront with the full personalization layout visible
Compare the desktop layout with the mobile capture when checking a device-specific issue.

For how touch editing behaves in detail, see mobile and touch editing.

Frequently asked questions

Which browsers do you support?

Use a current Chrome, Safari, Firefox, or Edge version and test the published product on the devices your shoppers use. Report any persistent issue with the exact browser version.

The customizer looks broken in my browser. What do I do?

Update to the latest version of your browser, or open the product in a different one. A very old browser cannot run the canvas, which makes the customizer look broken.

Does it work on phones?

The layout adapts to phones and tablets. Available fields and image tools depend on the product, and appearance comes from the store settings.

If a shopper has a current browser and the customizer still misbehaves, the issue is probably elsewhere. Read the customizer is not appearing or performance and slow loading, and contact support if you are still stuck.

Next: the customizer is not appearing.

Related articles