README

Build the commerce experience you imagine.

A complete open-source commerce foundation.
The freedom to shape your brand, your workflows, and your next idea.

Find your starting point · Try Shopware · Run locally · Developer docs

Your vision should shape your software. Not the other way around.

A distinctive brand needs more than a familiar checkout. It needs room to tell its story, express its personality, and turn a good idea into an experience customers remember.

Shopware gives you a complete commerce foundation and the source code to make it your own. Start with a working storefront, catalog, cart, checkout, and administration. Then build the product advisor, configurator, integration, or buying journey your business calls for.

See what makes Shopware different

These conceptual illustrations show possibilities, not recordings of the administration or promises of one-click features.

A brand people remember

Bring product discovery and your brand's story together with Shopping Experiences, themes, and custom frontends.

Static view · Explore Shopping Experiences

Commerce that works the way you do

Connect events, rules, and actions to automate repetitive workflows and make more time for customers and new ideas.

Static view · Explore Flow Builder

Open code. Your ideas. Your choice of agent.

Use your preferred coding agent to explore the implementation, develop extensions, and run tests. You remain in control of code review and deployment.

Static view · Agent instructions

Choose your starting point

Different projects need different first steps. Pick the path that fits what you want to do.

Curious about an experimental alternative? A community browser playground runs a Shopware demonstration using WebAssembly. It is a separate experiment, not the official hosted demo or production hosting. Optional agent features may require your own API key and provider charges.

Why developers choose Shopware

Build the interesting part. Keep the commerce foundation. Shopware is a PHP application based on Symfony, with a Vue.js administration, a Twig storefront, and APIs and extension points throughout the platform.

Exact supported versions depend on the Shopware release. See the installation requirements.

Shopware supports different extension models:

Compare extension options · Explore Shopware Frontends

Run Shopware locally

Pick your system. Create your project. Open your shop. The official Shopware CLI offers a guided Docker-based development environment.

1. Install Docker and the Shopware CLI

brew install --cask shopware/tap/shopware-cli

2. Create and start a project

shopware-cli project create my-shop
cd my-shop
shopware-cli project dev

The interactive dashboard guides setup and shows environment details, logs, and health checks. The first start includes downloads and installation.

3. Open your shop

With the default configuration, visit the storefront or administration. Use the actual URLs and credentials shown by your CLI if your setup differs.

Try creating a product, assigning it to the storefront sales channel, and opening it in the shop.

shopware-cli project dev status
shopware-cli project logs
shopware-cli project dev stop
shopware-cli project dev

Watch the official setup walkthrough · Full CLI documentation

This is a development setup, not production hosting. To contribute to Shopware itself, use the upstream contribution setup.

Extend Shopware your way

Choose the extension point that fits your project. For example, a storefront theme or plugin can override a Twig block without replacing the entire template:

{% sw_extends '@Storefront/storefront/component/buy-widget/buy-widget.html.twig' %}

{% block buy_widget_price %}
    {{ parent() }}
    <p class="delivery-note">Ships within 24 hours</p>
{% endblock %}

This is an illustrative snippet; follow the theme guides for a complete implementation. For integrations, use the Admin API or Store API, depending on the task.

Build with your preferred coding agent

Open source makes implementation details available to both developers and their tools. Coding agents can read project code, agent instructions, and development skills to help create and test extensions.

A useful first task:

Read the project's agent instructions and identify the Shopware version.
Help me build a small plugin for a gift-message feature.
First explain the supported extension points and the data flow.
Do not edit vendor files or core source. Propose a minimal implementation,
include a meaningful test, and show me how to disable the plugin again.

Review and test generated changes before deployment. A coding agent working with project files is different from an administrative agent connected to a running shop. Learn about the Shopware MCP server and the separate Agentic Commerce project; access depends on configuration and permissions.

Open source, with clear choices

The Shopware core is MIT-licensed. You can inspect, modify, and self-host it under that license. Hosting, commercial plans, Shopware Account and Store services, extensions, and external AI or payment providers may have separate terms and costs. Review the Community Edition Fair Usage Policy and current plans when choosing a deployment model.

Build with the community

You don't need to write a major feature to contribute. Improve a guide, reproduce a bug, translate Shopware, add a test, or share what you built.

• Ask and share: Community Hub · Discord · Forum
• Contribute code: Contribution guide
• Report issues: GitHub Issues
• Suggest improvements: Feedback portal
• Report security concerns privately: Security policy
• Follow new releases: Releases

Like what we're doing? Give us a star! ⭐

Thanks to all our contributors

Your next idea deserves room to grow.

Try Shopware · Run locally · Read the docs · Join the community