Headless Magento means your store keeps Magento for products, prices, orders and admin, while the pages shoppers see come from a separate front-end, called a storefront, connected to Magento through its API. This guide explains how it works, what changes and what stays, what it costs to run, and when it is worth it.
What is headless Magento?
In a standard Magento store, one system does everything: it renders every page, runs search and filters, handles the cart and checkout, and serves the admin. The front-end (the "head") and the back end are one piece.
In a headless setup, the head is removed and built separately. Magento still holds the catalogue, customers, prices, stock and orders. A separate storefront asks Magento for data through its GraphQL or REST API and renders the pages.
Is Magento a headless CMS?
No. Magento is an e-commerce platform, not a content management system. It has its own front-end, but it also has full APIs, so it can run "headless" behind any storefront. Content such as blog posts, banners and landing pages often moves to a separate headless CMS.
How headless Magento works
A typical headless Magento store has these parts:
- Magento keeps the catalogue, prices, stock, customers, cart, checkout and admin.
- The storefront renders the pages on its own server. For search engines it must render on the server (server-side rendering), so every page arrives as full HTML.
- A search and catalogue index serves categories, filters and search, so these requests don't reach Magento.
- A sync sends changes from Magento (new products, prices, stock) to the storefront, usually within minutes.
- A CDN such as Cloudflare caches pages and protects the store.
The cart and checkout can stay on Magento. Then the price and stock are always checked by Magento at the moment a product goes into the cart, even if the storefront shows a cached page.
Why stores go headless
The main reason is load, not design. In a standard Magento store, shoppers, search bots, ad traffic, site search and product reindexing all share one server and one database. When they hit at once, everyone waits in the same queue, including the shopper at checkout.
With a headless storefront:
- Browsing, filters and search run on a separate server, so bots and ad campaigns land there, not on Magento.
- Peaks in one store no longer slow down other stores on the same Magento.
- Design and content changes don't touch Magento, so they are faster and safer to release.
- Pages can be faster, because the storefront loads only the code each page needs.
What changes, and what stays
Stays the same: the Magento admin, checkout, prices and stock, customer group prices, back-end integrations such as ERP, email and payments, and, when it's done right, every URL and its SEO data.
Changes: catalogue, filters and search move to the storefront; images can be optimised automatically; the blog and content pages usually move to a headless CMS.
Needs rebuilding: anything your extensions show on the page, such as reviews, labels, banners, related products, chat widgets and tracking pixels. This list decides a large part of the project's cost, so make it first.
Pros and cons of headless Magento
| Pros | Cons |
|---|---|
| Traffic peaks and bots don't slow down checkout | One more server and a few more services to run |
| Front-end changes without touching Magento | Extensions that render on the page must be rebuilt |
| Faster pages, measured on your own store | A project of a few months, not a theme switch |
| Works with any Magento 2.x, no upgrade first | SEO must be moved carefully: URLs, meta, structured data |
Headless doesn't fix everything. Third-party scripts such as chat widgets and email pop-ups weigh the same on any front-end.
How much does headless Magento cost?
There are two parts.
The build is a project. For an established store it usually takes 3–4 months, depending on the number of stores, the extensions that show something on the page, and the integrations.
Running it adds hosting on top of your Magento hosting. As an example, a setup with 4 stores and about 38,000 products runs on one dedicated server (8 cores, 64 GB RAM, NVMe) for about $115 a month, plus Cloudflare Pro from $20 a month. Every store is different, so size the server on your own catalogue and traffic.
Which Magento versions can go headless?
Any Magento 2.x, including Adobe Commerce, because the storefront talks to Magento through its API. You don't need to upgrade Magento first.
Magento 1 reached end of life in June 2020 and no longer gets security updates. If you're still on Magento 1, start with an upgrade to Magento 2.
Headless, Hyvä or optimisation?
Headless isn't the only way to a faster store:
- Optimising your current theme gives quick wins: caching, images, scripts.
- The Hyvä theme makes the Magento front-end much lighter, but every request still reaches Magento.
- A headless storefront also takes the load of bots, ads and search off Magento.
If your store is stable and only the theme feels heavy, Hyvä or optimisation may be enough. If it slows down or goes down under traffic, headless is worth a look. A performance audit shows which case you are in.
A real example
For an industrial manufacturer, we added B2B ordering with customer prices, checkout and quotes using headless Magento 2 inside their existing TYPO3 website, without rebuilding the site or losing its SEO. Read the case study.
Questions about headless Magento
Is headless Magento good for SEO?
It can be, if the storefront renders pages on the server and keeps every URL, meta tag and structured data. A storefront that renders only in the browser can lose rankings.
Is headless Magento faster?
Usually, but measure it. Compare the same pages before and after, on mobile and desktop. Third-party scripts still count against your score.
Can we switch back if something goes wrong?
With a CDN in front, yes. Traffic can be sent back to the Magento front-end in minutes, and the cart stays in Magento.
Do we lose the Magento admin?
No. Products, prices, orders and customers stay in the Magento admin, as now.
Want to see how this works on a real catalogue? See our headless commerce for Magento service, with a live demo and a comparison of all three options.
