Field notes

Shopware development guides

Nine working-developer guides covering Shopware 6 migration, plugin development, headless architecture, the MCP server for AI agents, Elasticsearch/OpenSearch search, the HTTP QUERY method, and the Redis Streams setup that keeps your message queue out of the database. Written from real client projects.

In-depth guides
9
Total reading
97 min
Topics covered
7
Last updated
2026

Every guide here started as a real client problem I solved. 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, Elasticsearch/OpenSearch search, product import work), plugin development (your first plugin, the CLI workflow, the MCP server for AI agents), API development (the HTTP QUERY method and RFC 10008), 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.

API DEVELOPMENT New

The HTTP QUERY Method in Shopware 6 (RFC 10008)

What Symfony 7.4 already supports, a working Store API route with real 6.7.12.2 core code, and the HTTP cache gap nobody mentions.

10 min read Read Guide
SEARCH PERFORMANCE

Shopware 6.7 Elasticsearch/OpenSearch: Fixing Slow Search & Silent Fallbacks

The .env variable that prevents a silent MySQL fallback, shard planning you only get to do once, and where relevance tuning actually happens in 6.7.

11 min read Read Guide
AI INTEGRATION

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

Frequently asked questions

The questions that come up most often around these guides.

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