What does headless commerce actually mean?
- Type
- Applies to
- Medusa v2.x
- Updated
Short answer
Headless commerce means your storefront is a separate app that talks to a commerce backend through an API. The backend handles products, carts, orders, and payments; you build and host the frontend. Medusa is an open source headless platform with a Store API and a Next.js Starter Storefront, so you build the frontend, not commerce itself.
What headless commerce means in plain English
Headless commerce means the part of your store that shoppers see (the frontend, or "head") is a separate application from the part that runs commerce (the backend). The two talk over an API. The backend holds products, prices, carts, orders, and payments. The frontend is any website, app, or other client that calls that API.
In a traditional platform such as Shopify with a theme, the storefront and the backend come as one package. You customize the store inside the theme system. In a headless setup, your team builds and hosts its own storefront, often in a framework like Next.js.
123456789Traditional: Shopper -> [ Theme + checkout + backend, one platform ]Headless: Shopper -> Your storefront (Next.js, mobile app, kiosk, AI agent)|| API calls (products, cart, checkout)vCommerce backend (Medusa, Shopify, Saleor, commercetools)|Admin dashboard, database, payment and shipping providers
How headless commerce works in Medusa
Medusa is a headless commerce platform. Its docs describe the architecture directly: storefronts, admin dashboards, and other clients use Medusa through its API routes. The Medusa application is a Node.js server plus the Medusa Admin dashboard, and the storefront is deployed separately.
Medusa provides a Store API for storefronts and a Next.js Starter Storefront you can use as-is or build on. You are free to use another frontend stack. Medusa Cloud can host the backend, admin, and storefront together from one monorepo.
What you get versus what you build
Going headless does not mean building commerce from scratch. The backend gives you the commerce logic. You take on the frontend.
What headless commerce costs
Headless adds cost in three places compared with a theme-based store:
- Frontend development: someone builds and maintains the storefront. This is the largest cost and depends on your team.
- Frontend hosting: Shopify's Oxygen hosting is available at no extra charge on paid Shopify plans other than Agentic plans. Medusa Cloud plans start at $29 per month and include storefront hosting, with a 0% GMV fee (Medusa Cloud pricing).
- Ongoing changes: content and layout changes that a merchant makes in a theme editor may need a developer or a CMS.
The backend licence cost depends on the platform. Medusa and Saleor are open source. commercetools does not list prices on its site.
Headless commerce options compared
Hydrogen is the closest path if you already run Shopify and only want a custom frontend: checkout, plan fees, and apps stay on Shopify. Medusa fits when you also need to change backend logic, such as pricing rules, checkout steps, or order flows.
When you should not go headless
Headless is not the right default for every store. Stay on a theme-based platform if you have no developer, your store fits a theme, and you want merchants to change pages without code. Shopify's own pricing page lists 1 headless storefront on Basic, Grow, and Advanced, and 25 on Plus (Shopify pricing, as of October 2026), so headless is available there when you need it later.
Medusa is also not the right choice if you want a hosted SaaS with no code to own. Medusa assumes a developer can work with TypeScript and deploy changes.
Common questions
Is headless commerce more expensive than Shopify?
Usually at the start, because someone has to build and maintain the storefront. The backend can be cheap: Medusa is free to self-host and Medusa Cloud starts at $29 per month with a 0% GMV fee.
Do I need a developer for headless commerce?
Yes. A headless store needs a developer to build and change the storefront. If you don't have one, a theme-based platform such as Shopify is the better fit.
What is the difference between Hydrogen and Medusa?
Hydrogen is Shopify's toolkit for a custom frontend on Shopify's backend. Medusa is an open source backend you own and can extend with custom modules, used with the Next.js Starter Storefront or any frontend.
Can a headless backend serve more than a website?
Yes. Because Medusa exposes commerce through its API routes, the same backend can serve a website, a mobile app, or an AI agent.