Shopify glossaryGlossary5 min read
What Is Headless Commerce? How It Works and When Shopify Brands Need It
Headless commerce means building your storefront separately from the commerce engine behind it. Here is how it works on Shopify, what it costs you, and when a theme is still the better choice.
Key takeaways
- Headless commerce separates the storefront customers see from the backend that runs products, cart and checkout. The two talk through APIs.
- On Shopify, a headless store usually means a custom frontend built with Hydrogen or another framework, fed by the Storefront API, with Shopify's checkout behind it.
- Shopify itself says a headless storefront costs more to build and run than a theme, and needs developers after launch.
- Most stores, including many large ones, are better served by a well-built Online Store theme. Headless fits when the theme genuinely can't do the job.
- Who it is for
- Brands outgrowing a Shopify theme
- Time needed
- 5 minutes to read
- What you need
- A clear list of requirements
Headless commerce is a setup where the storefront customers see, the "head", is built separately from the commerce backend that manages products, carts and checkout, and the two communicate through APIs. On Shopify, that means you build your own frontend while Shopify's APIs supply products, collections, customers, the cart, checkout and international pricing.
A normal Shopify store is "headed": the theme, written in Liquid, and the backend come together, and you edit the storefront in the theme editor. Headless replaces the theme with your own code. I build both kinds of Shopify projects, and I'll be honest that most stores asking about headless don't need it. Shopify's own documentation was checked on 7 November 2026.
How headless commerce works on Shopify
Shopify documents several building blocks for headless stores:
- Hydrogen: Shopify's headless toolkit. It adds commerce features such as the cart, variant selection and collection filtering to frameworks like Next.js and React Router.
- Oxygen: Shopify's hosting for Hydrogen storefronts.
- Storefront API: serves products, collections, search and the cart, then hands customers off to Shopify checkout.
- Customer Account API: handles sign-in, orders, addresses and profile data.
- Headless channel: manages API access for storefronts you host yourself on any stack.
A typical headless example: a brand keeps its editorial content in a separate CMS, builds the site in Next.js, pulls products and prices from the Storefront API, and sends shoppers to Shopify checkout to pay.
Headless vs a Shopify theme
| Aspect | Shopify theme | Headless |
|---|---|---|
| Frontend | Liquid theme | Hydrogen or any framework |
| Editing pages | Theme editor | Depends on the build or CMS |
| Theme apps | Usually plug in | Often need custom work |
| Checkout | Shopify checkout | Shopify checkout via hand-off |
| Build and running cost | Lower | Higher |
| After launch | Merchant can manage | Developers maintain it |
When Shopify brands need headless
Shopify suggests considering headless when its sales channels, themes and apps can't support the systems, processes or customer experience you need. In practice that means cases like these:
- A storefront experience that themes can't reasonably deliver.
- A development team that already works in a non-Liquid stack.
- Adding Shopify commerce to an existing site, app or content platform.
- Selling on channels Shopify doesn't support out of the box.
- Content managed in a CMS that has to merge closely with the store.
Do you need headless?
- 1
Can a theme with custom sections do what you need?
Yes: stay on a themeNo: next question
- 2
Do you have developers to maintain it after launch?
Yes: headless is worth scopingNo: rethink the requirement
Speed alone is rarely a reason. A well-built theme can be fast, and a headless site is only as fast as its build.
Common misconceptions
- "Headless is automatically faster." Performance depends on the build. Many theme speed problems come from apps and heavy media, which headless doesn't fix by itself.
- "Headless converts better." Conversion comes from product pages, trust and checkout. Those can be just as good on a theme.
- "You lose Shopify checkout." You don't. The Storefront API hands customers off to Shopify checkout.
- Underestimating running costs. Every new feature, app and content change can need a developer.
Cost is the other half of the decision. Every project I take on gets a fixed quote, and for headless that quote covers more than the build: hosting, a CMS if you use one, and the developer time for changes a theme editor would let you make yourself. Put those running costs next to the problem you are solving before you commit.
Related terms
- Hydrogen, Oxygen and the Storefront API: Shopify's headless building blocks.
- Online Store 2.0: Shopify's section-based theme architecture, the main alternative.
- Composable commerce: a broader approach that assembles a store from separate services.
What to do next
- Write down what your theme can't do. Be specific. If the list is short, a custom section may solve it.
- Read the deeper guide. My article on Shopify Hydrogen and headless covers the build in more detail, and theme vs custom build compares the options.
- Get an honest opinion. I build custom Shopify stores through my Shopify development service. Every project gets a fixed quote after a free store review, and I'll tell you if headless isn't worth it.
Free tools
Check your own store
Free, no sign-up. Each one runs a part of this guide for you.
Frequently asked questions
What is headless commerce in simple terms?
It is an online store where the website customers see is built separately from the system that runs products, cart and checkout. The two connect through APIs, so you can change the front end without touching the commerce engine.
Does Shopify support headless commerce?
Yes. Shopify offers Hydrogen, a headless toolkit, Oxygen hosting for Hydrogen storefronts, the Storefront API and Customer Account API, and a Headless channel for storefronts you host yourself.
What are the benefits of headless commerce?
Full control over the storefront, freedom to use any frontend stack, and the ability to combine Shopify with an existing site, app or CMS. The tradeoff is higher build and running costs and a need for developers.
Is headless commerce faster than a Shopify theme?
Not automatically. Speed depends on how the site is built. A lean theme with few apps can be very fast, and a poorly built headless site can be slow.
Do I keep Shopify checkout with a headless store?
Yes. The Storefront API hands customers off to Shopify checkout, so payments and order processing still run through Shopify.
Sources
- About headless commerce, Shopify Developers
- Hydrogen, Shopify Developers
Related services and work
I'm a Shopify developer and CRO specialist. I have built and improved Shopify stores since 2018, completed more than 1,000 projects, and hold a 4.96 average rating across 719 client reviews.
More guides
-
Why Shopify Stores Lose Sales on Mobile: A Practical CRO Checklist
Mobile visitors decide fast, with one thumb and plenty of distractions. Here is how to find the leaks on a Shopify store and fix them in the right order.
-
Shopify CRO Audit Checklist for DTC Brands
The checklist I use to audit DTC Shopify stores, from checking that the data can be trusted to deciding which fixes to ship first.
-
When to Build a Custom Shopify App Instead of Adding Another Subscription
Another subscription is the quickest fix, until you are paying for five apps that still don't match how your business works. Here is how to decide.
-
How to Find Out What Theme a Shopify Store Uses
Every Shopify store names its theme in the page code. Here is where to look, how to read what you find, and what it means for your own theme choice.
-
How to See What Apps a Shopify Store Uses
Apps leave traces in a store's page code: scripts from their own servers, app embed folders and pixel settings. Here is how to read them, and what to do with the list.
-
How to Name a Shopify Store (and Check the Name Is Free)
A store name has to be easy to say, free as a domain and a handle, and clear of other brands. Here is the process I use with clients, and what Shopify lets you change later.
