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


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

ComponentFunctionExample vendors
PIMProduct data managementAkeneo, Salsify
SearchProduct search and discoveryAlgolia, Bloomreach
CMSContent managementContentful, Storyblok
CheckoutCart and payment processingStripe, Adyen
OMSOrder managementFluent Commerce
PersonalisationCustomer experienceDynamic 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

ConceptWhat it coversStatus
e-commerce-technology-stackThe full landscape of systems that power e-commercestub
product-information-managementOne of the key composable components — centralised product datacomplete
e-commerce-value-chainThe operational loop that composable architecture supportsstub

Some cards don't exist yet

A broken link is a placeholder for future learning, not an error.


Check your understanding


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:#fff

Related 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

Footnotes

  1. Shopify. (2025). What Is Composable Commerce?. Shopify Enterprise Blog. 2 3

  2. BigCommerce. (2026). Composable Commerce: What It Is and Why It Matters. BigCommerce. 2 3 4

  3. MACH Alliance. (n.d.). MACH Technology. MACH Alliance. 2 3 4