Saleor
Saleor Core is a headless commerce server with a GraphQL API.
Why consider Saleor?
Saleor is a headless, GraphQL-first e-commerce platform built with Python and Django.
Learn Saleor by building
Practical setup notes, real use cases, and copy-ready examples in one focused guide.
In this guide3 sections
Saleor is an enterprise-ready, API-first commerce platform designed for engineering teams that need a flexible, headless architecture. By focusing on scalability and avoiding vendor lock-in, Saleor allows businesses to create custom e-commerce experiences without relying on monolithic setups.
Why Choose a Headless Architecture?
A headless commerce platform completely separates the backend e-commerce logic from the frontend presentation layer. Saleor is a headless and API-only commerce platform, which means APIs are the exclusive way to configure or extend the backend. Rather than enforcing a specific templating engine or frontend technology, Saleor is designed around GraphQL, avoiding the fragmentation that comes from mixed API styles.
Using an API-first approach, Saleor allows you to seamlessly integrate any frontend framework, whether it is React, Vue, Next.js, or a dedicated mobile application. For global brands operating across regions, the platform provides a native multi-channel approach, enabling businesses to control stock, products, and currencies on a per-channel basis. Furthermore, the platform's extension mechanisms include webhooks, apps, and metadata, giving developers the tools they need to shape the checkout experience, process events asynchronously, and integrate with third-party tools like ERP or PIM systems.
Initializing the Platform
To simplify local development and deployment testing, Saleor provides a dedicated platform repository containing a complete Docker orchestration setup. Using Docker, you can run all components of Saleor locally by pulling the images and running docker compose up.
Begin by cloning the platform repository and pulling the necessary Docker images to your local machine:
git clone https://github.com/saleor/saleor-platform.gitcd saleor-platformdocker compose pullBefore you can start interacting with the local instance, Saleor requires applying database migrations before you can start using the local development setup. This ensures that your PostgreSQL database has the correct schema required by the current version of the API.
docker compose run --rm api python3 manage.py migrateOnce the migrations are successfully complete, you can optionally populate your database with sample data. This step is particularly useful for quickly exploring the dashboard's features without manually creating products, variants, and categories from scratch. Finally, you will need to create an administrator account to securely access the dashboard.
docker compose run --rm api python3 manage.py createsuperuserManaging Operations via the Dashboard
With the backend fully configured and the initial superuser created, you can launch the entire local environment. The intuitive Saleor dashboard provides direct access to product management, advanced order processing, and multi-channel configuration. Because the platform relies solely on its GraphQL API, every action taken in the dashboard accurately reflects what developers can programmatically accomplish.
Related tools
More options with a similar category or technology profile.
Sharetribe Web Template
Modern React and SSR marketplace web template for rental bookings and service listings.
Chromis POS
Touch-friendly retail point of sale and kitchen monitor software with multi-language support.
Lakasir
Modern, Progressive Web App (PWA) cashier and retail point of sale system.
Cezerin 2
Production-ready Node.js and React e-commerce platform with progressive web app (PWA) storefront.