saleor

From public sources

Saleor is an open-source, GraphQL-native headless commerce API for building scalable e-commerce platforms with multichannel, multi-currency and multi-warehouse support.

ApplicationCategory: Web Apps · E-commerce · ERP & accountingOpen sourcedata checked Oct 15, 2026

Overview

Building an online store on a monolithic platform often means fighting plugin conflicts, slow upgrades and a backend that is hard to extend. Saleor is an API-only commerce platform that handles the core of e-commerce (catalog, cart, checkout, orders, promotions, payments and customers) through a GraphQL API, so your storefront and business logic stay decoupled from the backend. Saleor supports per-channel pricing, currencies, stock and products, as well as multi-warehouse fulfilment, split payments, returns, translations and a flexible promotion engine. Extensions are built as independent apps using webhooks, metadata and subscription queries, which makes deployments, scaling and debugging easier. It is aimed at development teams that deploy often and need reliability, and it can be self-hosted with Docker Compose. Saleor is released under the BSD-3-Clause license, and a companion dashboard and open-source storefront example are available.
  • cart
  • checkout
  • commerce
  • composable
  • e-commerce
  • ecommerce
  • graphql
  • headless
  • headless-commerce
  • multichannel
  • oms
  • order-management

Installation

Commands are shown, never run by the marketplace. Check them against the official documentation.
  • Official websiteFrom public sourcesfrom catalog metadata
    saleor.io/ ↗
  • Language package registrynodejsFrom public sourcesfrom the package manifest — publication on the registry is not verified
    npm install -g saleor

    Not verified: check that this package in the registry belongs to this project before installing.

    www.npmjs.com/package/saleor ↗
  • Language package registrypythonFrom public sourcesfrom the package manifest — publication on the registry is not verified
    pipx install saleor

    Not verified: check that this package in the registry belongs to this project before installing.

    pypi.org/project/saleor/ ↗
  • Build from sourceFrom public sourcesfrom catalog metadata

    Build from source: no validated build recipe — follow the repository instructions.

    github.com/saleor/saleor ↗

Compatibility

Unknown means no evidence was found — not that the product is incompatible.
PlatformStatusArchitectureEvidenceConfidence
Web browserCompatible—Declared on the card—
Server / self-hostedUnknown———
Container (OCI)Unknown———
Node.jsCompatible—package manifest: package.json name0.60
PythonCompatible—package manifest: pyproject.toml name0.60

Releases

checked Oct 29, 2026
v3.23.45LatestOct 28, 2026Official source ↗

Files in 3.23.45

The marketplace does not host these files: downloads go to the official source. Files have not been scanned by us.
FilePlatformSizeSHA-256Download from the official source
schema.graphqlother1.1 MBbf37d116a6e0…Official source ↗

Release history

Quality profile

algorithm quality-v1.0 · assessed Oct 15, 2026
Quality Score100
Risk Score0
Confidence 1.00
Quality Score and Risk Score are different measures. A high score does not guarantee safety.

Score components

Maintenance · 2020
last activity 0 days ago
Documentation · 1515
README 9504 chars, description present
Ready to use · 1515
install instructions: yes; releases: yes
Metadata · 1010
4/4 of description, homepage, license, topics
Releases · 1010
10 release(s), latest 6 days ago
Category confidence · 1010
classifier confidence 1
Adoption · 1010
23442 stars (log-dampened, 10k = max)
License clarity · 55
SPDX BSD-3-Clause
Community · 55
issues enabled, 6145 forks

License

BSD-3-Clause
Known licensefrom the repository host

This is the catalog policy status, not legal advice.

Sources

github.com/saleor/saleorPrimary★ 23,442 starslast activity Oct 15, 2026Primary repository · Confidence 1.00

Reviews

Sign in to write a review

No reviews yet.

Alternatives

README

From saleor/saleor · license BSD-3-Clause · fetched Oct 29, 2026

Table of Contents

  • What makes Saleor special?
  • Why API-only Architecture?
  • Features
  • Installation
  • Documentation
  • Saleor Platform
  • Storefront
  • Dashboard
  • Contributing
  • License

What makes Saleor special?

  • Technology-agnostic - no monolithic plugin architecture or technology lock-in.

  • GraphQL only - Not afterthought API design or fragmentation across different styles of API.

  • Headless and API only - APIs are the only way to interact, configure, or extend the backend.

  • Open source - a single version of Saleor without feature fragmentation or commercial limitations.

  • Cloud native - battle tested on global brands.

  • Native-multichannel - Per channel control of pricing, currencies, stock, product, and more.

Why API-only Architecture?

Saleor's API-first extensibility provides powerful tools for developers to extend backend using webhooks, attributes, metadata, apps, subscription queries, API extensions, dashboard iframes.

Compared to traditional plugin architectures (monoliths) it provides the following benefits:

  • There is less downtime as apps are deployed independently.
  • Reliability and performance - custom logic is separated from the core.
  • Simplified upgrade paths - eliminates incompatibility conflicts between extensions.
  • Technology-agnostic - works with any technology, stack, or language.
  • Parallel development - easier to collaborate than with a monolithic core.
  • Simplified debugging - easier to narrow down bugs in independent services.
  • Scalability - extensions and apps can be scaled independently.

What are the tradeoffs?

If you are a single developer working with a small business that doesn't have high traffic or a critical need for 24/7 availability, using a service-oriented approach might feel more complex compared to the traditional WordPress or Magento approach that provides a language-specific framework, runtime, database schema, aspect-oriented programming, and other tools to a quick start.

However, if you deploy on a daily basis, reliability and uptime is critical, you need to collaborate with other developers, or you have non-trivial requirements you might be in the right place.

Features

  • Enterprise ready: Secure, scalable, and stable. Battle-tested by big brands
  • Dashboard: User-friendly, fast, and productive. (Decoupled project repo )
  • Global by design Multi-currency, multi-language, multi-warehouse, tutti multi!
  • CMS: Manage product or marketing content.
  • Product management: A rich content model for large and complex catalogs.
  • Orders: Flexible order model, split payments, multi-warehouse, returns, and more.
  • Customers: Order history and preferences.
  • Promotion engine: Sales, vouchers, cart rules, giftcards.
  • Payment orchestration: multi-gateway, extensible payment API, flexible flows.
  • Cart: Advanced payment and tax options, with full control over discounts and promotions.
  • Payments: Flexible API architecture allows integration of any payment method.
  • Translations: Fully translatable catalog.
  • SEO: Unlimited SEO freedom with headless architecture.
  • Apps: Extend dashboard via iframe with any web stack.

[Saleor Dashboard - Modern UI for managing your e-commerce]

Installation

See the Saleor docs for step-by-step installation and deployment instructions. For local development without Docker, follow our Contributing Guide.

Note: The main branch is the development version of Saleor and it may be unstable. To use the latest stable version, download it from the Releases page or switch to a release tag.

The current production-ready version is 3.x and you should use this version for all three components:

Saleor Cloud

The fastest way to develop with Saleor is by using developer accounts in Saleor Cloud.

Register here or install our CLI tool:

npm i -g @saleor/cli

and run the following command:

saleor register

Bootstrap your first storefront with:

saleor storefront create --url {your-saleor-graphql-endpoint}

Documentation

Saleor documentation is available here: docs.saleor.io

To contribute, please see the saleor/saleor-docs repository.

Saleor Platform

The easiest way to run all components of Saleor (API, storefront, and dashboard) together on your local machine is to use the saleor-platform project. Go to that repository for instructions on how to use it.

View saleor-platform

Storefront

An open-source storefront example built with Next.js App Router, React.js, TypeScript, GraphQL, and Tailwind CSS.

React Storefront Repository

View Storefront Example

Dashboard

For the dashboard, go to the saleor-dashboard repository.

Contributing

We love your contributions and do our best to provide you with mentorship and support. If you are looking for an issue to tackle, take a look at issues labeled Good first issue and Help wanted.

If nothing grabs your attention, check our roadmap or start a Discord discussion about a feature you'd like to see. Make sure to read our Contribution Guidelines before opening a PR or issue.

Get more details (e.g., how to run Saleor on your local machine) in our Contributing Guide.

License

Disclaimer: Everything you see here is open and free to use as long as you comply with the license. There are no hidden charges. We promise to do our best to fix bugs and improve the code.

Crafted with ❤️ by Saleor Commerce

hello@saleor.io

Open the repository ↗