Theme integration (Online Store 2.0)

ZenMerch integrates using Shopify’s supported extension architecture via a theme app embed. Once enabled, ZenMerch automatically loads the personalizer UI on targeted product pages—no manual theme code edits or app block placement required.

Enable the ZenMerch app embed

1. In ZenMerch, go to Settings → Theme integration.
2. Click Enable ZenMerch embed to open Shopify Theme Editor.
3. In Theme Editor: open App embeds (plug icon), enable the ZenMerch embed, then click Save.
4. Back in ZenMerch, click Refresh status to confirm the embed is enabled.

Click to enlarge

Verify it’s working

1. Open any targeted product page.
2. Confirm the ZenMerch UI appears on the product page.
3. Interact with inputs and confirm the preview updates.

Diagnostics

If you make changes in Theme Editor, use Refresh status inside ZenMerch to rescan the embed status.

Quick fixes (common Shopify setup issues)

• ZenMerch isn’t listed under App embeds: confirm the app is installed and your theme is Online Store 2.0. (Vintage themes don’t support App embeds.)
• Enabled, but not showing on storefront: make sure you edited the Live theme (or the same theme customers are viewing), then confirm the product is targeted by a template.
• Changes not updating: click Save in Theme Editor, then hard refresh the product page (or test in an incognito window).

Disable / uninstall

1. Shopify admin → Online Store → Themes → Customize.
2. Theme Editor → App embeds → toggle off ZenMerch → Save.
3. To uninstall: Shopify admin → Apps → ZenMerch → Uninstall.