Shopify Headless: When It Is Worth the Cost

Cover graphic for the guide 'Shopify Headless: When It Is Worth the Cost' on a purple background
Graphic: Ecom Field Guide
In this guide
  1. What “headless” means on Shopify
  2. What Hydrogen gives you, and what it leaves to you
  3. Hosting: Oxygen and alternatives
  4. The real cost: a checklist, not a number
  5. Who headless is actually for
  6. Vendor claims, read with care
  7. Alternatives to try first
  8. Email, subscriptions and other integrations
  9. Questions for a developer or agency
  10. A decision test

Disclosure: the author sells Shopify apps under Orbitloft, and those are admin apps, not storefront code. We have not built a headless storefront and this guide is based on Shopify’s documentation, not on a project of ours. See the disclosure page.

The short answer: most stores should not go headless. Shopify’s own documentation says a headless storefront costs more to build and run than a theme and needs developers to maintain it after launch, and that themes and apps are the default path. Headless is worth considering when a theme genuinely cannot do what your business needs: unusual front-end experiences, content from many systems, an app or mobile product sharing the same commerce backend, or a front-end team that wants its own framework.

What “headless” means on Shopify

Headless separates the storefront (the “head” customers see) from the commerce backend. Per Shopify’s headless overview, you build and host the front end with any stack, and Shopify’s APIs supply products, collections, customers, the cart, checkout and international pricing. The overview lists these routes:

  • Hydrogen, Shopify’s toolkit for building a full storefront in a JavaScript framework.
  • Native mobile with the Storefront API and Checkout Kit.
  • Bring your own stack, calling the Storefront API and Customer Account API directly.
  • Web Components or Buy Button JS to add products and buy buttons to a site you already have.
  • Shopify’s WordPress plugin, to sell Shopify products from WordPress.

The last two are worth noticing. “Headless” is not one decision: adding a buy button to an existing content site is a very different cost than building a custom storefront.

What Hydrogen gives you, and what it leaves to you

According to the Hydrogen documentation (version 2026-10 at the time we read it), Hydrogen adds Shopify-specific commerce logic to a framework you already use: a Storefront API client, cart, variant selection, collection filtering and analytics. It runs on frameworks that execute server code, such as Next.js, React Router, Nuxt, Astro or SvelteKit.

Now the part that decides the budget. The docs say you build:

AreaWho builds it
UI components, layout, styling, design systemYou (Hydrogen does not ship a component library)
Routing, data loading, rendering strategyYou
Session storage for customer tokensYou write the session manager; Hydrogen handles sign-in and token refresh
Account pages (profile, order history, addresses)You
Image handlingYou, with your framework’s image component or responsive tags
SEO: meta tags, Open Graph, structured dataYou
Checkout UIStays on Shopify
Admin API clientNot included; Hydrogen covers the Storefront and Customer Account APIs

Everything in a theme that “just works” (sections, SEO defaults, account pages, theme editor) becomes a line item.

Hosting: Oxygen and alternatives

Oxygen is Shopify’s hosting for Hydrogen. Shopify’s headless page says Oxygen is included at no extra charge on supported paid plans, subject to runtime and usage limits, and that Hydrogen can also be self-hosted on compatible infrastructure. The Hydrogen docs describe a React Router template deployed to Oxygen and a Next.js template (Vercel Shop) deployed to Vercel.

One loose end: the developer docs and Shopify’s marketing pages we read disagree about whether the lowest-priced plan is supported, and the page we fetched did not list supported plans. Check Shopify’s current supported-plans list rather than relying on us. Hosting is rarely the main cost; Shopify’s page itself says development, integrations, hosting and maintenance are separate budgets.

The real cost: a checklist, not a number

We will not quote a price range because the sources we read do not publish one and a made-up figure would mislead. Instead, price your own project with this table. Ask a developer or agency to fill in each row for both options.

Cost lineTheme storefrontHeadless storefront
Initial buildTheme purchase or customizationDesign plus full front-end build
Features parity (cart drawer, search, filters, reviews, subscriptions)Mostly app installs or theme settingsEach one integrated or built
SEO and analytics setupMostly defaultsBuilt and tested by you
Hosting and monitoringIncludedOxygen or other host, plus error monitoring
Ongoing maintenanceTheme updatesFramework, dependency and API-version upgrades
Who fixes a front-end bug at midnightTheme developer or Shopify support pathYour developer

Shopify’s article warns that your team owns the custom front end, including accessibility, security and API compatibility testing, and that front-end bugs can still interrupt browsing or purchases. Budget for a developer being available after launch, not only during the build.

Who headless is actually for

Headless tends to fit when most of these are true:

  • You have a specific front-end experience a theme cannot deliver, and you have tried.
  • You already have a development team, or a long-term agency relationship, to maintain code.
  • Shopify is one source among several (a CMS, a PIM, a custom configurator) feeding one site.
  • You need the same commerce backend for a website and a mobile app.
  • The upside of the custom experience is large enough to cover permanent extra cost.

It tends to be the wrong move when:

  • Your main goal is “faster” and you have not audited the apps and images on your current theme.
  • You are pre-product-market-fit and still changing the catalog and merchandising weekly.
  • You do not have an owner for the storefront code after launch.
  • A competitor looks fancier. That is not a requirement.

Vendor claims, read with care

Shopify’s headless page cites case-study results, including a brand-reported conversion increase and faster deployment cycles. These are vendor-reported, not independent, and each depends on the brand’s starting point. Treat them as examples of what is possible, not forecasts for your store.

Alternatives to try first

  1. Fix the theme. Remove unused apps and heavy scripts, compress images and test on real phones.
  2. Use sections and metaobjects for structured content instead of one-off custom pages.
  3. Use a buy button or Web Components on a content site you already run.
  4. Check app compatibility. If your business depends on apps, see how they behave before changing the front end; our guide to Shopify subscription apps shows how much of a store’s functionality lives in third-party apps.
  5. Hire for the narrow job. A theme developer can build one custom section for far less than a full storefront; see how to choose a Shopify agency for scoping advice.

Email, subscriptions and other integrations

A custom front end changes how every third-party feature reaches the customer. Email platforms that rely on onsite scripts for tracking browse and cart events need those scripts loaded by your own code; see our Klaviyo setup order for how onsite tracking works with a standard theme and compare it with what your developer would have to replicate. Subscription widgets, review stars, size guides and search tools are similar: on a theme they are mostly an install and a toggle, and on a headless build each is an integration with its own API and its own maintenance.

That is why a headless estimate should list every app your store uses today and say, per app, whether it works as is, needs a vendor-supplied integration, needs custom work, or gets dropped. If the answer for several revenue-critical apps is “custom work”, the project is larger than the design suggests.

Questions for a developer or agency

  • Which parts of our current store will be rebuilt, and which stay as they are?
  • Which of our apps work without changes, and who maintains the integration for the others?
  • How do you handle SEO: redirects, structured data, sitemaps, canonical tags?
  • How will we edit content after launch, and can a non-developer do it?
  • Who monitors errors and performance, and what is the response time for a checkout problem?
  • What happens when Shopify releases a new API version?

A firm that has done this before answers these specifically. Our guide on choosing a Shopify agency covers how to compare the answers, and our note on Shopify versus Amazon for new brands is worth reading if you are still deciding where to sell at all.

A decision test

Ask three questions in order:

  1. What specific customer or business outcome can a theme not deliver? Write it in one sentence.
  2. Have we tried to deliver it with theme customization, sections and apps? If not, try that first.
  3. If we proceed, who maintains the code next year and what does that cost per month?

If you cannot answer all three confidently, stay on a theme. Confirm current Hydrogen versions, supported plans and hosting limits on Shopify’s Hydrogen documentation before you commit.

Frequently asked questions

Is Hydrogen free?

The toolkit itself is a development framework you build with. Shopify's docs state that Oxygen hosting is included at no extra charge on supported paid Shopify plans, subject to runtime and usage limits. The expensive part is the developer time to build and maintain the storefront, not a license fee. Confirm which plans are supported on Shopify's current pages, because the sources we read disagree on the entry-level plan.

Does headless still use Shopify checkout?

Yes. Shopify's docs say the Storefront API manages the cart and then hands customers off to Shopify checkout, and Hydrogen does not provide a checkout UI. You get a custom storefront in front of Shopify's checkout, not a replacement for it.

Will my Shopify apps work on a headless storefront?

Do not assume so. Apps that add features by injecting into a theme need a different integration on a custom front end, and the docs we read do not give a compatibility list. Check each app you rely on with its developer before committing.

Is headless faster?

It can be, but it is not automatic. A custom front end gives you control over performance, and it also gives you the responsibility. A well-built theme with few apps can beat a badly built headless site. Measure your current store on real devices before assuming speed is your problem.

What is a sensible alternative to going headless?

Start with a theme and customize it, use sections and metaobjects for flexible content, and use apps where needed. Shopify's own overview says themes and apps come first and headless makes sense when they cannot meet your systems, processes or customer experience needs.