Skip to content

Shopify Hydrogen Development: When Should You Use Hydrogen?

What Shopify Hydrogen and Oxygen are, how Hydrogen development works, what it costs to own, decision signals and when to choose it over a Liquid theme.

01

Quick answer

Shopify Hydrogen is Shopify's framework for building a custom, headless storefront: a React Router application, preconfigured with Shopify components and utilities, that reads products and carts from the Storefront API and sends shoppers to Shopify's hosted checkout. It's usually deployed on Oxygen, Shopify's edge hosting, which is included on paid plans. Hydrogen suits brands whose storefront needs go beyond what a Liquid theme can deliver and who have development capacity to build and maintain a web application. For most stores, a well-built theme remains simpler and cheaper.

02

Hydrogen, Oxygen and Headless Shopify

Headless commerce means separating the storefront from the commerce back end. Shopify still manages products, inventory, pricing, orders, payments and checkout; your own front end handles the pages shoppers see. Hydrogen is one way to build that front end. For the broader decision, see Shopify headless commerce.

According to Shopify's documentation, Hydrogen projects are React Router apps preconfigured with Shopify-specific features, and Oxygen is Shopify's global deployment platform for hosting Hydrogen storefronts at the edge, with multiple environments for previewing changes.

Worth noting

Many articles still describe Hydrogen as built on Remix. That was true of earlier versions; current documentation describes it as built on React Router. Check the date of anything you read.

03

How a Hydrogen Storefront Works

In practice:

  • Routes and components are your code, in React
  • Product, collection, search and cart data come from the Storefront API
  • Customer accounts use the Customer Account API
  • Content can come from Shopify metaobjects or a headless CMS
  • The cart is created through the API and hands off to Shopify checkout
  • Pages render on the server and are cached at the edge on Oxygen
04

What Hydrogen Gives You

Control over the front end is the main benefit: page structure, routing, rendering and caching strategy, how much JavaScript ships, and how content from several sources combines on one page. That makes it possible to build experiences a theme can't, such as complex product configurators, content-heavy editorial commerce, or one front end serving several stores or markets with shared components.

Hydrogen also saves work compared with a general framework: Shopify-specific components for things like images, prices and cart, analytics helpers, and deployment to Oxygen without separate hosting.

05

What You Take On

Moving off a theme removes things you currently get for free.

With a Liquid themeWith Hydrogen
Theme editor for layout and contentA CMS or metaobjects plus custom components
App blocks add storefront featuresApps integrated through their APIs, if available
Theme developer or Shopify maintains core templatesYour team maintains the whole application
SEO basics output by the themeMetadata, sitemaps, redirects and structured data implemented by you
Any Shopify developer can work on itNeeds React and web application skills

Worth noting

Budget for ongoing development, not only the build. A Hydrogen storefront is a web application that needs dependency updates, API version upgrades, monitoring and new features.

06

SEO With Hydrogen

Hydrogen renders on the server, so pages are crawlable, but the SEO defaults a theme provides become your responsibility: title and meta tags, canonical URLs, sitemaps, robots rules, redirects and product structured data. Shopify documents SEO patterns for Hydrogen. If you're moving from a theme, treat it as a migration with URL mapping and redirects. See product structured data.

07

Performance

Server rendering, edge caching and control over client-side JavaScript give Hydrogen a strong performance ceiling. They don't guarantee it. Heavy client components, uncached API calls and third-party scripts slow any site. Compare against a well-optimized theme using real-user Core Web Vitals, not a demo. See website performance optimization.

Wondering whether Hydrogen fits your store?

ZSpace Labs assesses whether a theme, a customized theme or a headless build meets your requirements, before you commit to one.

Start a Project
08

Hydrogen vs a Liquid Theme

FactorLiquid themeHydrogen
Time to launchFasterSlower
Front-end flexibilityWithin theme architectureFull control
Content editingTheme editorCMS or metaobjects
App compatibilityBroad, via app blocksCase by case
Team skillsLiquid, CSS, JSReact, web app engineering
Ongoing ownershipLighterHeavier
09

Hydrogen vs Other Headless Frameworks

Shopify's APIs work with any front end. Next.js and other frameworks are sensible choices when your team already uses them, when the site includes a large non-commerce content or application layer, or when you want hosting outside Shopify. Hydrogen is the more direct path when the storefront is primarily commerce and you want Shopify's tooling and Oxygen. See Next.js website development and headless website development.

10

When Hydrogen Makes Sense

  • Storefront requirements a theme can't meet without being rebuilt
  • Content-rich experiences combining a CMS and commerce
  • Several storefronts or brands sharing components
  • An in-house or long-term development team with React experience
  • Budget for ongoing ownership, not just the build
11

When It Doesn't

  • The goal is only a faster store; optimize the theme first
  • The team relies on the theme editor and app blocks
  • No sustained development budget after launch
  • Requirements are business logic, which apps or Functions can handle
  • A new store still finding product–market fit
12

Moving From a Theme to Hydrogen

Most Hydrogen projects replace an existing theme rather than start from nothing. Treat the move as a migration of the front end, not a redesign bolted onto a new stack.

  • Inventory every template, section and app feature the current theme provides
  • Decide where each piece of editable content will live: metaobjects, a CMS or code
  • List apps with storefront features and confirm how each integrates without app blocks
  • Map every URL and plan redirects where paths change
  • Recreate analytics events and consent handling, then verify them
  • Rebuild structured data, sitemaps and metadata, and compare with the old theme's output
  • Run the new storefront against a baseline for speed and conversion before full cutover
13

Cost Drivers for a Hydrogen Build

A Hydrogen storefront's cost is driven by the number of distinct page types, how content is managed, how many apps need custom integration, the complexity of product configuration and search, internationalization, and the level of monitoring and testing required. Ongoing cost is driven by how often the business wants new features and how much of the storefront the internal team can maintain. See Shopify development cost.

14

Hydrogen Development Workflow

Hydrogen projects follow a modern web development workflow. Developers scaffold a project with Shopify's CLI, build routes and components on React Router with the Storefront API, connect a CMS or Shopify metaobjects for content, and deploy to Oxygen through a GitHub integration that creates preview deployments for branches, or to another host if self-hosting. Customer accounts use the Customer Account API. Analytics, consent and SEO need explicit implementation.

  • Project scaffolded with Shopify CLI
  • Routes, data loading and caching strategy defined
  • Content source chosen (CMS or metaobjects)
  • Customer Account API integrated
  • Analytics and consent implemented
  • SEO: metadata, sitemaps, structured data, redirects
  • Preview deployments and CI checks
  • Monitoring and error tracking
15

Decision Signals

Signals that Hydrogen development is worth considering: product experiences a theme struggles with (complex configurators, app-like browsing), content-rich storefronts with a separate CMS, several frontends sharing one backend, and a React team able to maintain it for years. Signals to stay with a theme: reliance on theme apps, merchandisers who need the theme editor, no in-house or retained developers, and requirements a theme already meets. For a full comparison including other headless frameworks, see Hydrogen vs traditional Shopify.

16

Hydrogen and Shopify Plans

Hydrogen and Oxygen are available beyond Plus. The plan difference is public Oxygen environments: 25 on Shopify Plus and 1 on other paid plans. Plan choice affects checkout customization, B2B features and other capabilities more than Hydrogen itself. Decide on Hydrogen and on Plus separately. See Shopify Plus development and Shopify Plus vs Shopify.

17

Planning a Hydrogen Project

Start with requirements and a proof of concept for the hardest part, often product configuration or content composition. Decide the content source, list every app and how it will integrate, map URLs and SEO requirements, define performance budgets, and set up environments and monitoring. Build the product, collection, cart and search journeys first.

Planning a headless Shopify build?

Talk to ZSpace Labs about Shopify development and web application development for Hydrogen and headless storefronts.

Start a Project
18

Conclusion

Hydrogen is a capable way to build a custom Shopify storefront, with Oxygen hosting included on paid plans. The trade-off is ownership: you become responsible for everything a theme and the theme editor used to handle. Choose it when requirements demand it and you can sustain it. Otherwise, a well-built theme is the stronger business decision. For the full range of build options, see Shopify store development.

FAQ

Common questions.

Hydrogen is Shopify's framework for building headless storefronts. Shopify describes Hydrogen projects as React Router apps preconfigured with Shopify-specific components, utilities and patterns for working with Shopify's APIs.

Oxygen is Shopify's global hosting platform for Hydrogen storefronts, running at the edge with separate deployment environments so changes can be previewed before production.

Shopify's documentation says Oxygen is available at no extra charge on paid Shopify plans. Development, maintenance and any third-party services are still your costs.

Hydrogen was originally built on Remix. Documentation for Hydrogen 2026-04 and earlier describes Hydrogen projects as React Router apps, following Remix's merge into React Router. Older articles may still refer to Remix. Since Hydrogen 2026-10 (14 October 2026), Shopify describes Hydrogen as a framework-agnostic JavaScript library with starters for React Router and Next.js, and existing Hydrogen storefronts keep working as they do now.

No. Oxygen is available at no extra charge on paid plans, including Starter, but not on Agentic plans. What differs by plan is the number of public Oxygen environments: 25 on Shopify Plus and 1 on other paid plans. Environments are private by default, and limits can change.

It can be, because you control rendering, caching and what JavaScript ships. But a well-optimized Liquid theme is fast too, and a poorly built Hydrogen site can be slow. Speed comes from the implementation, not the framework alone.

Apps that manage data in the admin generally still work. Apps that inject storefront features through theme app blocks don't appear automatically; you integrate them through their APIs or SDKs, if they offer them.

Not through the theme editor. Teams usually edit content in a headless CMS or in Shopify metaobjects, with components built to render it. Plan this before building.

Checkout remains Shopify's hosted checkout. Your storefront creates the cart through the Storefront API and sends shoppers to checkout.

Hydrogen gives Shopify-specific tools and Oxygen hosting. A general framework such as Next.js suits teams already invested in it or with content needs beyond commerce. Both use the same Shopify APIs.

Get in touch

Have a project in mind?

Whether you're building a new digital product, improving an existing website, or looking to automate part of your business — let's talk.