Headless Shopify: Hydrogen

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 storefrontSupportedWhat it takes
Shopify theme (Online Store)YesSwitch on the app embed. See Storefront setup.
Shopify HydrogenYesYour developer adds the SureBright script and keeps Hydrogen's standard cart and product conventions.
Shopyflow (Shopify on Webflow)YesYour developer adds the SureBright script.
Another headless Shopify front endAsk firstTalk 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.

What is different from a theme store#

On a Shopify themeOn 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 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:

  1. Add the SureBright script to every page

    It carries your store's address, so SureBright knows which store the storefront belongs to.

  2. Say that the storefront is Hydrogen

    One line of configuration. It saves the script from guessing.

  3. 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.

  4. 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.

  5. Test and tell SureBright

    Place one test order with a plan and ask SureBright to confirm the plan was created. See Test your setup.

If the offer does not show#

What you seeUsual cause
No offer on any pageThe 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 variantsThe 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 orderingThe storefront dropped the plan's details between the cart and the order.
The offer is missing on product or cart pages onlyThose 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.

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.