> For the complete documentation index, see [llms.txt](https://docs.sylius.com/public/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sylius.com/public/readme.md).

# Sylius Documentation

<figure><img src="/files/feBxfML6InJDX0Oyy8kL" alt=""><figcaption></figcaption></figure>

## 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.

{% hint style="info" %}
Sylius is MIT licensed. [Sylius Plus](https://sylius.com/plus) is the commercial edition with enterprise features and official support.
{% endhint %}

***

### 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**

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><mark style="color:$success;">Why Sylius?</mark></h4></td><td><em>When off-the-shelf platforms aren't enough: what Sylius is built for and who it's built for.</em></td><td><a href="/pages/9kqMF1dHz4FlZrsBCJXy">/pages/9kqMF1dHz4FlZrsBCJXy</a></td></tr><tr><td><h4>Live Demo</h4></td><td><em>Explore a running Sylius store - shop and admin - before you install anything.</em></td><td><a href="https://demo.sylius.com">https://demo.sylius.com</a></td></tr><tr><td><h4>Open Source</h4></td><td><em>Release cycle, backwards compatibility promise, license, and the people behind Sylius, everything you need for due diligence.</em></td><td><a href="/pages/AJIMTDpQ8Q3AGl75rgtF">/pages/AJIMTDpQ8Q3AGl75rgtF</a></td></tr><tr><td><h4>Addons</h4></td><td><em>Browse official and community plugins - payments, shipping, search, and more - built for Sylius and ready to install.</em></td><td><a href="https://addons.sylius.com/en_US/">https://addons.sylius.com/en_US/</a></td></tr><tr><td><h4>Sylius Academy</h4></td><td><em>Official video courses for getting productive with Sylius quickly: from first install to advanced customization.</em></td><td><a href="https://academy.sylius.com/">https://academy.sylius.com/</a></td></tr><tr><td><h4>Partners</h4></td><td><em>Meet the agencies and technology companies in the Sylius ecosystem or learn how to become one.</em></td><td><a href="https://sylius.com/find-a-partner/">https://sylius.com/find-a-partner/</a></td></tr></tbody></table>

### **Installing**

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>Before You Begin</h4></td><td><em>PHP, Symfony, and Composer prerequisites + plus the learning resources worth bookmarking first.</em></td><td><a href="/pages/GtfiEM2Kn5lnblswrjov">/pages/GtfiEM2Kn5lnblswrjov</a></td></tr><tr><td><h4>Install with Docker</h4></td><td><em>The fastest path to a running local store. Two commands and you're in.</em></td><td><a href="/pages/KC8NbELT8AufeBf7zzul">/pages/KC8NbELT8AufeBf7zzul</a></td></tr><tr><td><h4>Install without Docker</h4></td><td><em>Manual setup for teams with an existing PHP and MySQL environment.</em></td><td><a href="/pages/AzdRfRu3sh9vHhXQmNDJ">/pages/AzdRfRu3sh9vHhXQmNDJ</a></td></tr></tbody></table>

### **Building**

<table data-view="cards"><thead><tr><th></th><th></th><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>Basic Configuration</h4></td><td><em>Channels, locales, currencies, and zones, the foundation every Sylius store is built on.</em></td><td align="center"></td><td><a href="/pages/8SevyXCKmQxvrhws7tVM">/pages/8SevyXCKmQxvrhws7tVM</a></td></tr><tr><td><h4>Your First Product</h4></td><td>S<em>hipping method, payment method, and your first product listing - end to end.</em></td><td align="center"></td><td><a href="/pages/eeGYjk4ODwp0XVmuuMPj">/pages/eeGYjk4ODwp0XVmuuMPj</a></td></tr><tr><td><h4>The Book 🔒</h4></td><td><em>The complete reference for every Sylius concept. Requires login.</em></td><td align="center"><a href="https://docs.sylius.com/the-book" class="button primary" data-icon="input-password">Log in with Sylius Connect</a></td><td><a href="https://docs.sylius.com/the-book">https://docs.sylius.com/the-book</a></td></tr></tbody></table>

### Two editions, one codebase

<figure><img src="/files/hGGGDJVQEw0yLHo58C9u" alt=""><figcaption></figcaption></figure>

**Community Edition (CE)** is the free, MIT-licensed distribution. Everything in this documentation applies to CE unless marked otherwise. [View on GitHub →](https://github.com/Sylius/Sylius)

**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 →](https://sylius.com/plus)

***

### 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**.

<div align="left"><figure><img src="/files/u6mJzCSMwdMaYGTjB9v1" alt=""><figcaption></figcaption></figure></div>

***

#### ✨ 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.

{% stepper %}
{% step %}

#### **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.
{% endstep %}

{% step %}

#### **Shop MCP Server**

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

{% step %}

#### **Documentation MCP Server**&#x20;

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

{% step %}

#### **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.
{% endstep %}
{% endstepper %}

<h4 align="center">Read the <a href="https://docs.sylius.com/ai-development-guide" class="button primary" data-icon="book-sparkles">AI Development Guide</a> <em>(login required)</em></h4>

***

### Community & resources

* [Slack](https://sylius.com/slack) — Questions, discussions, and the core team
* [GitHub](https://github.com/Sylius/Sylius) — Issues, contributions, and ADRs
* [Roadmap](https://sylius.com/roadmap) — What's planned and feature voting
* [Blog](https://sylius.com/blog) — Release notes, case studies, and updates
* [Contributing](/public/open-source/contributing.md) — How to get involved in the project
* [Contact](https://sylius.com/contact) — Get in touch with the Sylius team


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sylius.com/public/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.