commercetools

On this page 7

commercetools is a cloud-native, API-first commerce platform delivered as software as a service, which exposes catalog, pricing, cart, order and customer functions as independent APIs rather than as a packaged storefront. E-commerce teams use it as the transactional core of a headless or composable architecture, connecting their own frontends, search engines, content systems and payment providers around it.

Among store platforms, commercetools sits at the enterprise end of the spectrum. It was founded in Munich in 2006 and became a co-founder of the MACH Alliance, the industry group that promotes microservices, API-first, cloud-native and headless principles. Unlike WooCommerce or Magento, it ships no theme layer and no installable code: everything the shopper sees is built by the merchant or an agency.

How commercetools structures commerce as APIs

commercetools organizes all data inside a project, a multi-tenant container hosted in a chosen cloud region on Google Cloud or AWS. Each project offers REST and GraphQL endpoints for the same resources, so a frontend can fetch a product with its prices and inventory in one GraphQL query or call granular REST resources from a backend service.

Access is controlled with OAuth 2.0 client credentials and fine-grained scopes such as read-only product access or order management. This allows a storefront, an ERP connector and a warehouse service to receive separate API clients with the minimum permissions each one needs, which limits damage if one credential leaks.

The main resource groups below form the core of the platform and map closely to the vocabulary used by commerce architects.

Resource groupWhat it holdsTypical consumer
Product types and productsAttribute schemas, variants, SKUs, assetsStorefront, PIM sync
Prices and standalone pricesCurrency, country, channel and customer group pricesPricing engine, frontend
Carts and ordersLine items, discounts, taxes, shipping, order stateCheckout, OMS, ERP
Customers and business unitsAccounts, addresses, B2B hierarchies, rolesAccount pages, CRM
Stores and channelsBrand, country or warehouse scoping of dataMulti-brand frontends, fulfillment
PaymentsRecords of payment transactions and statesPayment service connectors
Core resource groups in commercetools

Two extension mechanisms make the API core adaptable. API Extensions call an external HTTP endpoint or serverless function synchronously during an update, for example to validate a cart or add a fee. Subscriptions push change messages asynchronously to queues such as AWS SQS, Google Pub/Sub or Azure Service Bus, which is the standard way to trigger downstream systems without polling.

Key capabilities and product modules

The platform has grown from a single commerce API into a suite of modules that can be licensed and adopted separately. The core remains the commerce engine, while surrounding modules address the frontend, checkout and administration gaps that headless projects traditionally had to fill themselves.

ModulePurposeNotes
Composable CommerceCatalog, pricing, cart, order and customer APIsThe transactional core of every project
Merchant CenterBrowser-based back office for business usersExtensible with custom applications
FrontendFrontend-as-a-service layer and page builderBased on the acquired Frontastic product
CheckoutHosted checkout and payment integration layerReduces custom checkout development
ConnectHosting and marketplace for integrationsRuns connectors inside the platform
Main commercetools modules and their roles

Pricing is a frequent reason for selecting commercetools. A single variant can carry many scoped prices that differ by currency, country, customer group, channel and validity dates, and the API selects the correct price at query time. Cart discounts, product discounts and discount codes stack according to explicit sort order and stacking modes, which supports complex promotional rules for B2C and B2B selling.

How commercetools compares with other store platforms

commercetools differs from most store platforms because it is headless by design, not headless as an option. Shopify Plus and BigCommerce offer headless APIs alongside their own storefronts, while Magento and Shopware can be decoupled but remain monolithic applications that the merchant or a host must operate.

PlatformArchitectureHosting modelTypical buyer
commercetoolsPure API-first, composableMulti-tenant SaaSLarge enterprise, complex catalogs
Shopify PlusIntegrated SaaS with headless APIsMulti-tenant SaaSFast-growing and enterprise brands
BigCommerceOpen SaaS with headless APIsMulti-tenant SaaSMid-market retailers
MagentoMonolithic, modular PHP applicationSelf-hosted or managed cloudTeams needing code-level control
MedusaOpen-source headless frameworkSelf-hosted or vendor cloudDeveloper-led projects
commercetools compared with related platforms

The trade-off is flexibility against time to market. commercetools removes the upgrade burden of self-hosted software and scales elastically, but every customer-facing feature must be designed, built and integrated. A merchant gains architectural freedom while accepting higher initial engineering effort than with an integrated platform.

When commercetools is the right choice

commercetools fits organizations whose requirements exceed packaged platforms: several brands or countries on one backend, large catalogs with rich attributes, B2B account hierarchies, or the need to swap search, content and payment vendors independently. It suits teams that already run in-house engineering or work with an experienced systems integrator.

SituationRecommendationReason
Multi-brand, multi-country operationStrong fitStores and channels scope one shared project
Complex B2B pricing and accountsStrong fitBusiness units and scoped prices are native
Small store with a standard catalogPoor fitBuild cost outweighs the benefits
No frontend or integration teamPoor fit without a partnerNothing customer-facing ships by default
Replatforming a legacy monolith graduallyGood fitAPIs allow a strangler migration step by step
Decision guide for adopting commercetools

A common adoption path is the strangler pattern: the cart and checkout move to commercetools first while the old platform still serves catalog pages, and further domains migrate in later releases. The Import API supports bulk loading of products, prices and inventory during this transition.

Limitations and common mistakes

The most frequent mistake is treating commercetools as a finished online store. It provides no search relevance tuning, no content management and no payment processing; its payment resource only records transactions, while a payment service provider performs the actual authorization and capture.

  • Total cost of ownership includes licensing, frontend development, integrations and ongoing operations, and licensing is usually tied to order volume or gross merchandise value.
  • Data model decisions about product types and attributes are hard to reverse once millions of products depend on them.
  • Synchronous API Extensions add latency to every affected update, so slow endpoints degrade checkout performance.
  • Documented API limits on query complexity and resource counts must be considered when designing very large carts or catalogs.
  • Too many vendors in a composable stack can create integration sprawl that no single team fully owns.

In simple terms

commercetools is like the engine room of an online store without the shop window. It keeps track of products, prices, shopping carts, customers and orders, and it answers requests from any screen that asks for that information.

The company selling online builds its own shop window, such as a website, an app or a kiosk, and connects it to this engine. The benefit is freedom: the store can look and behave exactly as the business wants. The cost is effort, because someone has to build and connect all the visible parts.

A practical example

A European sporting goods group sells under three brands in twelve countries and runs a separate legacy platform for each brand. Updating prices for a seasonal sale requires changes in three back offices, and launching a new country takes about nine months.

The group moves to commercetools with one project, three stores and country-specific channels. A shared product catalog holds about 80,000 variants, while scoped prices handle each currency and dealer customer group. The brands keep distinct frontends built on a common component library, and Subscriptions send every new order to the existing warehouse system through a message queue.

After the migration, a price change is made once and reaches all relevant stores, and the next country launch takes roughly three months instead of nine. The trade-off is a permanent platform team of developers who maintain the frontends and integrations.