What does headless commerce actually mean?

Type
Concept
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.

Traditional: Shopper -> [ Theme + checkout + backend, one platform ]
Headless: Shopper -> Your storefront (Next.js, mobile app, kiosk, AI agent)
|
| API calls (products, cart, checkout)
v
Commerce 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.

AreaWith MedusaStatus
Products, variants, categoriesProduct ModuleNative
Prices, currencies, price listsPricing ModuleNative
Cart, checkout logic, ordersCart and Order ModulesNative
Admin dashboardMedusa AdminNative
StorefrontNext.js Starter Storefront, installed with create-medusa-app, that you customizeNative
Product reviews, loyalty points, subscriptionsOfficial tutorials with example codeOfficial guide
B2B company accounts and quotesB2B StarterStarter
Business-specific logicCustom modules and workflowsCustom

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

OptionBackendFrontendHostingPricing model
Shopify HydrogenShopifyHydrogen (framework-agnostic, with a React Router starter)Oxygen or self-hostedShopify plan fees and apps
MedusaOpen source (MIT core), Node.js and TypeScriptNext.js Starter or any frameworkSelf-hosted or Medusa CloudFree to self-host; Cloud from $29 per month, 0% GMV fee
SaleorOpen source, GraphQL APIAny frameworkSelf-hosted or Saleor CloudCheck vendor docs
commercetoolsHeadless, API-first platform for enterpriseAny frameworkVendor cloudNot public, through sales

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.