Composable Commerce
An architecture approach where every component of the e-commerce system — storefront, checkout, search, content, payments — is independent, replaceable, and connected by APIs.
What is it?
Most e-commerce businesses start with a monolithic platform — Shopify, WooCommerce, Magento — where everything is bundled together: the storefront, the checkout, the product catalogue, the search engine, the content management system, and the payment processing. This is convenient. One vendor, one system, one login. It works well until it does not.
The moment a business needs something the platform cannot do — a custom checkout flow, a different search engine, a unique content experience — the monolith becomes a constraint. Customisation is limited to what the platform allows. Switching one component means switching everything.1
Composable commerce is the opposite approach. Instead of one bundled system, each function is handled by a separate, specialised service: one for product data (PIM), one for search, one for checkout, one for content, one for payments. These services communicate through APIs and can be replaced independently. If the search engine is not good enough, you swap it for a better one without touching anything else.2
The concept is formalised by the MACH Alliance as four principles: Microservices (each function is a self-contained service), API-first (all communication happens through APIs), Cloud-native (built for cloud infrastructure, not servers in a closet), and Headless (the frontend presentation layer is decoupled from the backend logic).3
In plain terms
A monolithic platform is a pre-built kitchen where the oven, fridge, and dishwasher are all built into one unit. Convenient, but if the oven breaks, you might need to replace the whole thing. Composable commerce is a modular kitchen where you pick the best oven, the best fridge, and the best dishwasher separately. If the fridge breaks, you replace just the fridge.
At a glance
The architecture spectrum (click to expand)
graph LR M[Monolithic] -->|Decouple frontend| H[Headless] H -->|Decouple all components| C[Composable] M --- M1["Everything bundled<br/>e.g. Shopify"] H --- H1["Frontend separated<br/>Backend still bundled"] C --- C1["Every component<br/>independent + swappable"]Key: The spectrum runs from fully bundled (monolithic) to fully modular (composable). Headless is the intermediate step where only the frontend is separated. Composable takes the principle to every component.
How does it work?
The monolithic starting point
A monolithic platform bundles everything: storefront templates, product management, checkout, payment processing, search, and content management. Shopify is the clearest example — you sign up, pick a theme, add products, and you are selling. The platform handles everything, and the trade-off is that you work within its constraints.1
This works well for most businesses at the start. The constraints only become painful at scale or when the business needs something the platform was not designed to do.
Think of it like...
A smartphone where you cannot change the camera, the battery, or the operating system independently. It works well out of the box, and most people never need to change the parts. But a professional photographer might need a better camera module, and the only option is to buy an entirely different phone.
Headless: the first separation
Headless commerce separates the frontend (what the customer sees) from the backend (where products, orders, and payments are managed). The backend exposes its data through APIs, and the frontend is built independently — as a custom website, a mobile app, a voice interface, or anything else.2
This gives designers and developers full control over the customer experience without being limited to platform templates. The backend still handles the commerce logic, but it no longer dictates how things look or where they appear.
Think of it like...
Separating the engine from the car body. The same engine (backend) can power a sedan, an SUV, or a sports car (different frontends). Each body is designed for a different purpose, but they all run on the same engine.
Composable: every component independent
Composable commerce extends the headless principle to every component. Instead of one backend doing everything, each function is handled by a best-of-breed service:3
| Component | Function | Example vendors |
|---|---|---|
| PIM | Product data management | Akeneo, Salsify |
| Search | Product search and discovery | Algolia, Bloomreach |
| CMS | Content management | Contentful, Storyblok |
| Checkout | Cart and payment processing | Stripe, Adyen |
| OMS | Order management | Fluent Commerce |
| Personalisation | Customer experience | Dynamic Yield |
Each service connects to the others through APIs. An orchestration layer (often the frontend or a middleware) coordinates the services. The business picks the best tool for each job and is never locked into a single vendor for everything.2
Think of it like...
Building with LEGO instead of carving from a single block of wood. Each LEGO piece (component) snaps into place and can be removed or replaced without affecting the others. The wood block is strong and looks good, but if you want to change one part, you are carving again from scratch.
The MACH principles
The MACH Alliance formalises the composable approach into four architectural principles:3
Microservices — each business function runs as its own service with its own data and logic. If the search service goes down, the checkout still works.
API-first — every service exposes its functionality through APIs, not through a bundled interface. This is what makes swapping possible.
Cloud-native — services run on cloud infrastructure (AWS, GCP, Azure) with automatic scaling. No physical servers to manage.
Headless — the presentation layer is completely decoupled. The same backend services can power a website, a mobile app, an in-store kiosk, and a voice assistant.
Why do we use it?
Key reasons
1. Freedom to pick the best tool for each job. A monolithic platform forces you to use its built-in search, its checkout, its content tools. Composable lets you choose Algolia for search because it is better at search, Stripe for payments because it handles more currencies, and Contentful for content because your marketing team prefers it.2
2. Replace without rebuilding. When a component becomes outdated or a better option appears, you swap just that component. The rest of the system stays untouched. In a monolith, upgrading one part often means upgrading everything — or migrating to a new platform entirely.1
3. Scale where you need it. If Black Friday drives ten times the normal search traffic, you scale the search service without scaling the order management system. Each component scales independently based on its own demand.3
When do we use it?
- When the monolithic platform’s limitations are blocking business goals (custom checkout, unique content experiences, specific integrations)
- When selling across many channels that each require a different frontend experience
- When the business has the engineering team (or agency partners) to manage multiple services
- When vendor lock-in is a strategic risk the business wants to avoid
- When performance and scalability requirements exceed what a single platform can deliver
Rule of thumb
If the monolith still works and you are not fighting it, stay with it. Composable commerce is a response to real constraints, not a goal in itself. The added flexibility comes with added complexity and cost.
How can I think about it?
The modular kitchen
A pre-built kitchen unit comes with a fixed oven, fridge, dishwasher, and countertop — all from one manufacturer, all designed to fit together. You unpack it, install it, and start cooking. It is fast and it works.
But the oven only goes to 200 degrees, and you need 250. The fridge is too small for your family. The dishwasher is fine, but a newer model uses half the water. In a pre-built unit, replacing the oven might mean replacing the entire counter section it is mounted in.
A modular kitchen lets you pick the best oven, the best fridge, the best dishwasher, and connect them independently. If the fridge breaks in three years, you replace just the fridge. The trade-off: you need to measure everything, ensure the connections work, and coordinate multiple suppliers. It takes longer to set up, but you get exactly what you need.
LEGO vs a wood carving
A monolithic platform is like a wooden sculpture — carved from a single block, beautifully integrated, but rigid. If you want to change the arm, you carve a new sculpture.
Composable commerce is like building with LEGO. Each brick (service) connects to others through standard connectors (APIs). You can rearrange the bricks, swap one colour for another, or add new sections without dismantling the whole structure.
LEGO takes longer to build than buying a pre-made sculpture. It requires more skill to make it look good. But when you need to change something — and you always do — the LEGO model wins. The sculpture sits on a shelf looking beautiful until the day you need it to be something else.
Concepts to explore next
| Concept | What it covers | Status |
|---|---|---|
| e-commerce-technology-stack | The full landscape of systems that power e-commerce | stub |
| product-information-management | One of the key composable components — centralised product data | complete |
| e-commerce-value-chain | The operational loop that composable architecture supports | stub |
Some cards don't exist yet
A broken link is a placeholder for future learning, not an error.
Check your understanding
Test yourself (click to expand)
- Explain the difference between monolithic, headless, and composable commerce. Why is headless not the same as composable?
- Name the four MACH principles and describe what each one means in practice.
- Distinguish between the trade-offs of a monolithic platform and a composable architecture. When is each the better choice?
- Interpret this scenario: a mid-size retailer on Shopify wants to add AI-powered search, a custom loyalty programme, and a mobile app with a unique interface. Their developer says the current platform cannot support these features natively. What architectural shift would you recommend, and what are the risks?
- Connect composable commerce to product-information-management. How does a PIM function as one of the composable components, and what happens to product data management in a monolithic platform?
Where this concept fits
Position in the knowledge graph
graph TD TS[E-Commerce Technology Stack] --> CC[Composable Commerce] TS --> PIM[Product Information Management] EC[E-Commerce] --> TS style CC fill:#4a9ede,color:#fffRelated concepts:
- product-information-management — in a composable architecture, the PIM is an independent, API-connected component rather than a built-in feature of the platform
Sources
Further reading
Resources
- MACH Technology (MACH Alliance) — The official definition of MACH principles from the industry alliance that coined the term
- Composable Commerce Explained (BigCommerce) — Thorough overview with architecture diagrams and vendor comparison
- What Is Composable Commerce? (Shopify) — A monolithic vendor’s honest take on when composable makes sense and when it does not
- Headless Commerce Explained (Contentful) — Focuses on the headless step of the spectrum, useful for understanding the intermediate architecture
- The Composable Enterprise (Gartner) — Gartner’s definition and strategic framing of composable commerce for enterprise decision-makers
Footnotes
-
Shopify. (2025). What Is Composable Commerce?. Shopify Enterprise Blog. ↩ ↩2 ↩3
-
BigCommerce. (2026). Composable Commerce: What It Is and Why It Matters. BigCommerce. ↩ ↩2 ↩3 ↩4
-
MACH Alliance. (n.d.). MACH Technology. MACH Alliance. ↩ ↩2 ↩3 ↩4
