Sylius Documentation

Sylius, Open-Source eCommerce Framework

Sylius is a headless, open-source eCommerce framework built on Symfony. It gives development teams complete control over every layer of their commerce application - the data model, the business logic, the checkout flow, and the frontend.

Unlike SaaS platforms like Shopify or hosted solutions like WooCommerce, Sylius is a framework. You own the code, the infrastructure, and every customization. Nothing is hardcoded. Everything is replaceable.

Sylius is MIT licensed. Sylius Plus is the commercial edition with enterprise features and official support.

Built for projects that outgrow standard platforms

Sylius is the right choice when off-the-shelf solutions can't be made to fit — not because of missing features, but because they're too rigid at the architecture level.

🏗️ Complex B2C and B2B commerce Custom checkout flows, tiered pricing, organization-level accounts, and tax logic that matches your actual business, not a platform's assumptions about it.

🌍 International storefronts Multi-currency, multi-locale, multi-channel, managed from a single admin, deployable across unlimited storefronts.

🔌 Headless & API-first Sylius as a backend, paired with any frontend, React, Vue, Next.js, or a native mobile app. The REST API is built on API Platform and designed to stay out of your way.

🔗 Enterprise integrations Connect with ERPs, CRMs, and PIMs through a clean, extensible API. No workarounds. No hacks.

Start here

New to Sylius? These are the best entry points depending on where you are.

Evaluating

Why Sylius?

When off-the-shelf platforms aren't enough: what Sylius is built for and who it's built for.

Live Demo

Explore a running Sylius store - shop and admin - before you install anything.

Open Source

Release cycle, backwards compatibility promise, license, and the people behind Sylius, everything you need for due diligence.

Addons

Browse official and community plugins - payments, shipping, search, and more - built for Sylius and ready to install.

Sylius Academy

Official video courses for getting productive with Sylius quickly: from first install to advanced customization.

Partners

Meet the agencies and technology companies in the Sylius ecosystem or learn how to become one.

Installing

Before You Begin

PHP, Symfony, and Composer prerequisites + plus the learning resources worth bookmarking first.

Install with Docker

The fastest path to a running local store. Two commands and you're in.

Install without Docker

Manual setup for teams with an existing PHP and MySQL environment.

Building

Basic Configuration

Channels, locales, currencies, and zones, the foundation every Sylius store is built on.

Your First Product

Shipping method, payment method, and your first product listing - end to end.

The Book 🔒

The complete reference for every Sylius concept. Requires login.

Two editions, one codebase

Community Edition (CE) is the free, MIT-licensed distribution. Everything in this documentation applies to CE unless marked otherwise. View on GitHub →

Sylius Plus is the commercial edition, built on top of CE, adding RBAC, multi-source inventory, a B2B pricing engine, return management, and priority support from the core team. Learn more →

Trusted in production

Sylius powers commerce for organizations across retail, logistics, media, and enterprise — including Carrefour, Forbes, PwC, Mytheresa, Intersport, Poczta Polska, Dr. Oetker, Einhell, Würth, Jägermeister, IQOS, and Raiffeisen NetWorld.

✨ AI-powered commerce (experimental)

Sylius 2.x ships with a suite of AI development tools: both for building Sylius projects with AI assistance, and for exposing your store to AI agents at runtime.

Sylius AI Dev Tools

Connects your AI assistant directly to your running Sylius project, giving it real-time access to your resources, hooks, grids, and routes. One command to set up, works with any MCP-compatible AI client.

Shop MCP Server

exposes your storefront to AI agents: product search, price lookup, and order placement through natural conversation.

Documentation MCP Server

Gives AI assistants direct access to Sylius documentation, so they can answer Sylius-specific questions accurately while you build.

Store Wizard

Automates the setup of a fully configured Sylius store: products, themes, and plugins included. Useful for spinning up a working POC without manual configuration steps.

Community & resources

Slack — Questions, discussions, and the core team
GitHub — Issues, contributions, and ADRs
Roadmap — What's planned and feature voting
Blog — Release notes, case studies, and updates
Contributing — How to get involved in the project
Contact — Get in touch with the Sylius team

NextIntroduction to Sylius