(G) Field notes

Shopware development guides

Seven working-developer guides covering Shopware 6 migration, plugin development, headless architecture, the new MCP server for AI agents, and the Redis Streams setup that keeps your message queue out of the database. Written from real client projects.

In-depth guides
7
Total reading
76 min
Topics covered
6
Last updated
2026

Every guide here started as a real client problem I solved, not a content-mill brief or an AI-generated outline. If a guide is short, that's because the answer is short. If it's long, it's because the topic genuinely needs the depth.

Topics covered: migration (Shopware 5 to 6), performance (Redis Streams for the message queue, product import work), plugin development (your first plugin, the CLI workflow, the MCP server for AI agents), architecture (headless vs. Twig), and troubleshooting (cache, indexing, plugin conflicts).

Who these are for: Shopware merchants making architecture decisions, and the developers implementing them. If you're stuck and Stack Overflow let you down, start here.

AI INTEGRATION New

Shopware MCP Server: Connect Your Store to AI Agents

Plug Shopware 6 into Claude, ChatGPT, and Cursor through the Model Context Protocol. Official server install, security guardrails, and the merchant workflows that actually pay back.

11 min read
Read Guide
MIGRATION Popular

How to Migrate from Shopware 5 to Shopware 6: A Complete 5-Step Guide

A step-by-step guide covering data migration, theme conversion, plugin compatibility, testing, and go-live strategies for Shopware 6 migration.

12 min read
Read Guide
TROUBLESHOOTING Popular

How to Fix 3 Common Shopware 6 Errors (Cache, Indexing, Plugin Conflicts)

Troubleshoot and resolve the three most common Shopware 6 errors: cache issues, indexing failures, and plugin compatibility conflicts with practical solutions.

8 min read
Read Guide
ARCHITECTURE

Shopware Headless & Composable Architecture: A Practical Guide for Decision Makers

Headless, composable, and micro-frontends for Shopware: costs, trade-offs, and a decision framework.

15 min read
Read Guide
DEVELOPMENT TOOLS

Shopware CLI: Complete Developer Workflow Guide

Master shopware-cli to automate extension uploads, build assets faster, refactor code automatically, and cut the boring parts out of your Shopware workflow.

12 min read
Read Guide
PLUGIN DEVELOPMENT Popular

Building Your First Shopware 6 Plugin

Learn how to create a custom Shopware 6 plugin from scratch. CLI scaffolding, manual setup, bootstrap class, and production optimization tips.

10 min read
Read Guide
SYSTEM ARCHITECTURE

Scaling Shopware 6.7: Stop Using Your Database as a Queue

Replace Shopware's default Doctrine DBAL message queue with Redis Streams for better performance under high traffic. Production-ready setup guide.

8 min read
Read Guide

Frequently asked questions

The questions that come up most often around these guides.

How long does a Shopware 5 to 6 migration take?
Two months minimum for a small B2C catalog, six to twelve months for a complex B2B store with custom plugins and a non-standard theme. Theme work and plugin compatibility usually take longer than the data migration itself. The migration guide above has the full breakdown.
Do I need to rewrite my theme for Shopware 6?
Yes. Shopware 5 themes don't run in Shopware 6. Templating, build system, and storefront API are all different. An audit decides between a Twig theme port, a fresh Twig theme, or going headless with Vue Storefront or Nuxt.
When should I use headless Shopware vs. the default Twig storefront?
Twig is right when you have a single storefront, a small team, and standard commerce flows. Headless makes sense for multi-channel (web, native app, POS), a separate frontend team, or content and composability needs that Twig can't easily serve. The architecture guide covers the trade-offs in detail.
Are the guides up to date with Shopware 6.7?
Yes. The Redis Streams guide is written against 6.7. The migration, plugin, CLI, and MCP guides target 6.6+ and work on 6.7. The error-fixing guide covers cache, indexing, and plugin-conflict issues that span 6.5 through 6.7.
Can I hire you to implement what's in these guides?
Yes. Most of these guides started as client work. If you want help, the contact form on the homepage is the fastest route.

Need Help with Your Shopware Project?

These guides cover common scenarios, but every project has unique challenges. Get personalized guidance from a Certified Shopware Developer.

Talk to an Engineer