---
title: "Headless Shopify: Hydrogen"
description: "SureBright works on Shopify Hydrogen and other headless Shopify storefronts. What you get, what is different from a theme store, and what your developer needs to do."
---

Yes, SureBright works on a headless Shopify storefront. Shopify Hydrogen has its own built-in support, and so does Shopyflow, which runs Shopify on Webflow. This page tells you what you get, what is different from a store on a Shopify theme, and what to hand your developer.

| Your storefront | Supported | What it takes |
| --- | --- | --- |
| Shopify theme (Online Store) | Yes | Switch on the app embed. See [Storefront setup](/shopify/storefront-setup). |
| Shopify Hydrogen | Yes | Your developer adds the SureBright script and keeps Hydrogen's standard cart and product conventions. |
| Shopyflow (Shopify on Webflow) | Yes | Your developer adds the SureBright script. |
| Another headless Shopify front end | Ask first | Talk to SureBright before you build. Support depends on how your storefront handles its cart. |

## What you get on Hydrogen

- The protection offer on your product pages, in your design.
- The plan added to the cart as its own line when a shopper chooses one.
- The plan kept in step with the product in the cart: the same quantity, and removed when the product is removed.
- Orders with a plan turned into plans for your customers, the same way as on any Shopify store, because your orders still go through Shopify.
- Sales, attach rate and billing in the [Merchant Portal](/merchant-portal/overview).

## What is different from a theme store

| On a Shopify theme | On Hydrogen |
| --- | --- |
| You switch on the SureBright app embed in the theme editor. | There is no theme, so there is nothing to switch on. Your developer adds one script to the storefront. |
| **Settings → Storefront setup** in the Merchant Portal shows whether the embed is on. | That check does not apply. Your developer confirms the offer on the storefront, and SureBright confirms the first test order. |
| The offer finds its place on the page by itself. | SureBright sets the placement for your storefront once it is ready. Tell SureBright when it is. |
| A design can be [targeted](/merchant-portal/design-targeting) at a theme or template with no extra work. | Your developer has to tell the widget which theme or template a page stands for. |
| Shopper consent follows Shopify's consent banner. | If your storefront has its own consent manager, tell SureBright. |

## What to hand your developer

Send your developer this list and the two developer pages below. In plain words, they need to:

<Steps>
  <Step title="Add the SureBright script to every page">
    It carries your store's address, so SureBright knows which store the storefront belongs to.
  </Step>
  <Step title="Say that the storefront is Hydrogen">
    One line of configuration. It saves the script from guessing.
  </Step>
  <Step title="Keep Hydrogen's standard product form and cart">
    The widget reads the selected variant and the cart the way the Hydrogen starter template provides them, and adds the plan through the storefront's own cart.
  </Step>
  <Step title="Carry the plan's details through to the order">
    Each plan line carries hidden details that tie it to the product it covers. If the storefront drops them, the order arrives with a plan SureBright cannot set up.
  </Step>
  <Step title="Test and tell SureBright">
    Place one test order with a plan and ask SureBright to confirm the plan was created. See [Test your setup](/platforms/test-your-setup).
  </Step>
</Steps>

<CardGroup cols={2}>
  <Card title="SDK installation" href="/frontend-widget-integration/frontend-widget-kit/sdk-installation#shopify-hydrogen-and-other-headless-shopify-builds" icon="code">
    The script tag and the Hydrogen requirements, step by step.
  </Card>
  <Card title="Headless and custom storefronts" href="/frontend-widget-integration/frontend-widget-kit/headless-and-custom-storefronts" icon="book">
    How the pieces fit together, what breaks when one is missing, and how to verify.
  </Card>
</CardGroup>

## If the offer does not show

| What you see | Usual cause |
| --- | --- |
| No offer on any page | The script is missing your store's address, or the storefront was not declared as Hydrogen. |
| The offer shows the wrong plan or none on some variants | The product form no longer exposes the selected variant in the standard way. |
| A plan is in the cart but the customer gets no plan after ordering | The storefront dropped the plan's details between the cart and the order. |
| The offer is missing on product or cart pages only | Those pages do not use the usual `/products/` and `/cart` addresses. |

Your developer can confirm each of these with the checks in [Headless and custom storefronts](/frontend-widget-integration/frontend-widget-kit/headless-and-custom-storefronts#what-breaks-when-a-step-is-skipped).

## Before you start

Tell your SureBright contact that your storefront is headless before your developer begins. Placement, design and which offers are switched on are finished on SureBright's side before the offer goes live for your shoppers.

## Related

- [Supported platforms](/platforms/overview)
- [Storefront setup](/shopify/storefront-setup) for stores on a Shopify theme
- [Shopify Markets pricing](/shopify/markets)
- [Offer not showing?](/help/offer-not-showing)
