Eine Headless-Migration auf Shopware ist kein Theme-Update mit Extras. Sie ist ein eigenständiges Projekt mit Phasen, Stakeholdern, Risiken und einem klaren Übergangsplan. Wer die Phasen kennt, vermeidet die typischen Fehler und kann das Projekt auch in kleinen Schritten kontrolliert ausrollen.

Dieser Guide zeigt sechs Phasen, jeweils mit Zielen, typischer Dauer und den häufigsten Stolperfallen.

Phase 0: Vorbereitung, bevor das Projekt offiziell startet

Ziel: Klarheit über Geschäftsziel, Stakeholder, Budget, Zeithorizont.
Typische Dauer: 1 bis 2 Wochen.

In dieser Phase fixieren Sie das „Warum": Performance, Multi-Markt, Marketing-Velocity, BFSG-Compliance, oder eine Kombination. Aus dem Warum ergibt sich die Priorisierung und damit, wo das Projekt scharf gestellt wird.

Identifizieren Sie zwei Schlüssel-Stakeholder: eine technische Verantwortung (idealerweise jemand, der die bestehende Shopware-Installation und Plugins kennt) und eine Marketing-Verantwortung. Ohne diese Doppelspitze kippt das Projekt in jede Richtung in den Stillstand.

Häufiger Fehler: Migration starten, weil „alle headless gehen". Ohne klares Geschäftsziel keine messbaren Erfolge.

Phase 1: Discovery und Architektur

Ziel: Technische Bestandsaufnahme, Architektur-Entscheidung, Vendor-Auswahl.
Typische Dauer: 3 bis 5 Wochen.

Inventarisieren Sie Ihren bestehenden Shopware-Stack: aktive Plugins, Theme-Customizings, Drittsysteme (ERP, PIM, CRM, OMS), Datenflüsse, Sales Channels, Customer Groups, B2B-Suite-Konfigurationen. Was wird übernommen, was wird ersetzt, was fällt weg?

Treffen Sie die Frontend-Entscheidung: Shopware Frontends oder eine Frontend Management Platform wie Laioutr? Diese Frage wird im Detail in Shopware Frontends vs. Laioutr entschieden.

Häufiger Fehler: Frontend-Plugins werden im Audit übersehen. Eine vermeintliche Mini-Plugin (Pop-up, Reviews, Search) kann das Go-live um Wochen verzögern, wenn ihre Funktionalität zu spät ersetzt wird.

Phase 2: Setup und Integration

Ziel: Frontend-Plattform aufsetzen, Shopware-Anbindung herstellen, Drittsysteme integrieren.
Typische Dauer: 2 bis 4 Wochen.

Mit Laioutr richten Sie Studio ein, verbinden Storefront API und Admin API über die Shopware-Integration, konfigurieren App-Integrationen (Reviews, Suche, Personalisierung) und docken Drittsysteme über den App Store an. Bei einem Frontends-Setup steht hier die Repo-Struktur, das Hosting-Deployment und das State-Management.

Häufiger Fehler: Die Storefront-API-Token werden zu eng geschnitten oder mit zu wenigen Sales Channels verbunden. Späteres Nachtragen kostet Zeit. Lieber großzügig planen.

Phase 3: Komponenten- und Theme-Aufbau

Ziel: Tatsächliche Storefront bauen: Produktdetail, Listing, Home, Landingpages.
Typische Dauer: 4 bis 10 Wochen, je nach Branding-Tiefe.

Hier zeigt sich, ob Ihre Wahl der Plattform Time-to-Launch hält. Mit Laioutrs UI-Bibliothek (70+ Komponenten) und einem Theme starten Sie nicht bei null. Branding-Anpassungen, individuelle Komponenten und spezifische Funktionalität wie B2B-Suite-Spezifika oder besondere Konfiguratoren bauen Sie auf der bestehenden Basis.

Häufiger Fehler: Designsystem und Komponenten werden parallel zur Storefront entwickelt, statt vorgelagert. Das führt zu Doppel-Arbeit und inkonsistenten Komponenten.

Phase 4: Datenmigration und Inhalts-Transfer

Ziel: Bestehende Inhalte (Blog, statische Pages, SEO-Content) sicher übertragen.
Typische Dauer: 2 bis 3 Wochen.

Shopware-CMS-Pages, Custom-Snippets, eingebettete Plugin-Inhalte: alles, was Inhalte trägt, muss inventarisiert und migriert werden. Mit Laioutr Studio bauen Sie diese Pages neu auf, oft mit Verbesserungen am Layout, weil Sie ohnehin redesignen.

Häufiger Fehler: Blog-URLs werden vergessen. Dann verlieren Sie organischen Traffic, der über Jahre aufgebaut wurde.

Phase 5: SEO-Übergang und Redirects

Ziel: Bestehende Rankings retten, Backlinks erhalten, neue Architektur bei Google sauber registrieren.
Typische Dauer: 1 Woche, parallel zu Phase 4.

Drei Bausteine müssen sitzen:

Erstens: eine vollständige 301-Redirect-Map. Jede alte Shopware-URL bekommt eine neue. Achten Sie besonders auf Kategorie-URLs, Filter-Parameter und Pagination. Shopware-URLs haben oft eine Struktur, die im Headless-Frontend abweicht.

Zweitens: saubere Hreflang- und Canonical-Tags, vor allem wenn Sie über Sales Channels mehrere Märkte fahren.

Drittens: Schema.org-Markup neu setzen: Organization, Product, BreadcrumbList, FAQPage. Strukturierte Daten sind ein direkter Ranking-Faktor und gerade auf Shopware oft suboptimal implementiert.

Häufiger Fehler: Alte Sitemap.xml wird vergessen, Google indexiert tagelang ein Mischmasch aus alten und neuen URLs. Lieber kontrolliert deindexieren und neu submitten.

Phase 6: Go-live, Monitoring, Iteration

Ziel: Live gehen und sicherstellen, dass nichts kippt.
Typische Dauer: Go-live an einem Werktag, Stabilisierung 2 bis 3 Wochen.

Gehen Sie nicht freitags live. Gehen Sie an einem Dienstag oder Mittwoch live, mit Engineering, Marketing und Customer Care anwesend. Beobachten Sie in den ersten 72 Stunden besonders: Conversion-Rate, Bounce-Rate, Core Web Vitals, Server-Response-Times der Storefront API, Search-Console-Auffälligkeiten.

Häufiger Fehler: Go-live ohne Rollback-Plan. Wenn etwas Großes bricht, müssen Sie in 30 Minuten zurück können. Das heißt, die alte Twig-Storefront muss notfalls wieder aktiviert werden können.

Typische Gesamt-Timeline

Für einen mittleren Shopware-Shop mit klarem Branding und ohne exotische Plugin-Konstrukte: 12 bis 20 Wochen vom Kickoff bis zum Go-live. Mit Multi-Sales-Channel-Setup, B2B Suite oder umfangreichen ERP-Anbindungen entsprechend mehr.

Welche Partner Sie unterstützen

Eine Headless-Migration auf eigene Faust ist möglich, aber selten der schnellste Weg. In Deutschland haben sich für Shopware-Headless mit Laioutr besonders bewährt: basecom für Migrationen und B2B-Setups, dasburo für DTC-Brands mit Performance-Fokus, mds Agenturgruppe für Multi-Brand-Setups, FATCHIP und valantic für Enterprise-Migrationen. Eine vollständige Liste finden Sie im Bereich Partner.

Fazit: Migration ist Projektmanagement, nicht Magie

Eine erfolgreiche Headless-Migration auf Shopware scheitert selten an der Technologie. Sie scheitert an unklaren Zielen, fehlender Stakeholder-Doppelspitze oder einer SEO-Phase, die zu spät bedacht wird. Wer die sechs Phasen sauber durchgeht, hat einen kontrollierten Übergang, kein Risiko-Projekt.

Wenn Sie eine konkrete Migration planen, gehen wir mit Ihnen einen Audit durch. Ehrlich, mit konkretem Phasenplan und realistischer Timeline für Ihren Setup.

• Demo anfragen
• Headless für Shopware im Detail
• Wann lohnt sich der Umstieg überhaupt?

Weiterführend: Headless Frontend für Shopware.

Weiterführende Ressourcen: Composable Headless Frontend und Content-Management.

Mehr dazu: Salesforce Commerce Cloud Headless Migration, Schritt für Schritt und Spryker Headless Migration, Schritt für Schritt.