Skip to main content
Hemsy Embeds let shoppers open the full Hemsy try-on experience in a modal on your own storefront. Any element on the page can become a launcher. However it’s installed, an embed comes down to three knobs: Everything else in these docs is payload detail or recipes for those three knobs.

Choose your install

There are two ways to put Hemsy on a storefront. Both load the same embed script and use the same launcher attributes — the only difference is who writes the markup.

Shopify theme extension

For Online Store themes. Enable the app embed and add trigger blocks from the theme editor. No code, and Hemsy handles the cart for you.

Script tag

For headless Shopify storefronts (Hydrogen, custom frontends) and any page where you own the markup. One script tag plus launcher attributes.

Configure it

These pages apply to both install paths — the theme extension’s settings map one-to-one onto the same launcher attributes you’d write by hand.

Launch modes

Sandbox, product context, Bundle, Share, Flow, and Instant, plus which one wins when a launcher has multiple attributes.

Checkout vs Cart

Decide what the final CTA does, and sync Hemsy with your own cart state.

JavaScript API

Open and close Hemsy programmatically with window.HemsyEmbed.

Deep Links

Payload schemas, bundle attributes, and URL encoding shared by embeds and hosted links.