Eigene Mailvorlagen im Shop: wo Updates nicht ankommen

Den Anfang machte Shopware 6.7.14.0 am 9. September 2026 (Shopware Release Notes 6.7.14.0). Die Version brachte das EU-weit einheitliche Label für gewerbliche Haltbarkeitsgarantien, in Shopware GARAN genannt, und einen Link auf die harmonisierte Mitteilung zum gesetzlichen Gewährleistungsrecht. Diese Mitteilung liefert Shopware übersetzt in alle 24 Amtssprachen der EU aus (Shopware Release Notes 6.7.14.0). Beides wurde in die Vorlage der Bestellbestätigung eingebaut, allerdings nur dort, wo diese Vorlage noch der unveränderte Systemstandard war: in neuen Installationen und in Shops, die sie bis dahin unverändert gelassen hatten. Wer die Bestellbestätigung angepasst hatte, sollte die beiden Aufrufe laut Release Notes selbst in die eigene Vorlage einfügen.

Am 1. Oktober 2026 folgte 6.7.15.0 (Shopware Release Notes 6.7.15.0). Das Label war in der ersten Fassung ohne feste Maße in einer eigenen Tabellenzeile über die volle Breite ausgegeben worden, sodass Mailprogramme die Grafik auf Mailbreite hochskalierten und abschnitten. Jetzt trägt es Breite und Höhe, steht in der Beschreibungszelle der Position und hat einen übersetzten Alternativtext. Zugleich wechselte Shopware vom SVG als data-URI zu einem eingebetteten PNG, weil Gmail und Outlook die SVG-Fassung laut Release Notes nicht anzeigen. Auch diese Änderung spielte eine Migration nur in Shops ein, deren Vorlage unbearbeitet war. Wer das Markup aus 6.7.14.0 schon in die eigene Vorlage kopiert hatte, musste es ein zweites Mal ersetzen.

Sechs Tage später, am 7. Oktober 2026, kam 6.7.15.1. Die Bestellbestätigung liest das Label nun aus der neuen Vorlagenvariable garanLabels, und der Twig-Filter sw_garan_label_mail aus 6.7.15.0 ist abgekündigt (Shopware Release Notes 6.7.15.1). Im Upgrade-Leitfaden für Shopware 6.8 steht er bereits als entfernt (Shopware UPGRADE-6.8). Eine angepasste Vorlage, die den Filter weiter aufruft, funktioniert in 6.7 noch. Nach dem Sprung auf 6.8 meldet Twig an dieser Stelle einen Fehler, weil der Filter dann nicht mehr registriert ist. Shops auf dem älteren Zweig 6.6 bekamen das eingebettete PNG mit 6.6.10.28 am 1. Oktober und die Variable statt des Filters mit 6.6.10.29 am 7. Oktober 2026 (Shopware Release Notes 6.6.10.28, Shopware Release Notes 6.6.10.29).

Hinter dem Tempo steht ein fester Termin. Die Richtlinie (EU) 2024/825 verpflichtet die Mitgliedstaaten, ihre Umsetzungsvorschriften ab dem 27. September 2026 anzuwenden (Richtlinie (EU) 2024/825). In Deutschland steht die Pflicht in Art. 246a § 1 EGBGB: Händler informieren über das gesetzliche Gewährleistungsrecht einschließlich seiner Mindestdauer von zwei Jahren mit der harmonisierten Mitteilung und über eine Haltbarkeitsgarantie des Herstellers von mehr als zwei Jahren mit der harmonisierten Kennzeichnung (Art. 246a § 1 EGBGB). Wie das Label auf Produktseite, Liste und Warenkorb gepflegt wird, beschreibt der Beitrag zum Gewährleistungslabel im Shop. Hier geht es um die Frage dahinter: warum eine Änderung, die Shopware ausliefert, in einer angepassten Mailvorlage nicht ankommt.

Shopware liefert eine ganze Reihe von Mailvorlagen mit, von der Registrierung über die Bestellbestätigung bis zu den Statusmails für Lieferung und Zahlung. Welche davon in welcher Situation verschickt wird, legt der Flow Builder fest, und durch Erweiterungen können weitere Vorlagen hinzukommen (Shopware-Dokumentation). Angepasst wird in der Regel nicht die ganze Liste, sondern die Handvoll Mails, die jeder Kunde sieht und an denen Geld oder Rechte hängen.

Zwei weitere Gruppen fallen bei der Inventur leicht durch. Die erste sind neue Systemvorlagen, die ein Update mitbringt: 6.7.14.0 hat zum Beispiel eine Vorlage samt Flow für fehlgeschlagene Zahlungen ergänzt (Shopware Release Notes 6.7.14.0). Sie kommt im Shopware-Standard an, nicht im Design des Shops, und steht dann neben angepassten Mails, die anders aussehen. Die zweite Gruppe sind Kopf- und Fußzeilen. Sie werden je Verkaufskanal zugewiesen (Shopware-Dokumentation) und tragen in vielen Shops Anbieterangaben und Kontaktwege. Ändert sich dort etwas, betrifft es alle Mails dieses Kanals zugleich.

Der Abgleich zeigt, was in der Vorlage stehen sollte. Ob es beim Kunden ankommt, zeigt erst der Versand. Die Verwaltung bietet dafür im Editor einen Testversand an eine frei wählbare Adresse und eine Vorschau (Shopware-Dokumentation). Seit 6.7.11.0 rendert die Vorschau mit dem gewählten Verkaufskanal und dessen Kopf- und Fußzeile (Shopware Release Notes 6.7.11.0), seit 6.7.15.0 rendert der MailService jede Mail mit den Textbausteinen ihres Verkaufskanals (Shopware Release Notes 6.7.15.0). Für die Prüfung heißt das: Ein Test im falschen Kanal zeigt die falschen Texte.

Testmail und Vorschau arbeiten in der Regel mit Beispieldaten. Das Label erzeugt Shopware laut Release Notes aber nur für Produkte mit Hersteller und vollständigen Label-Daten (Shopware Release Notes 6.7.14.0). Ob die Zeile in der eigenen Vorlage greift, zeigt deshalb erst eine echte Bestellung auf der Staging-Umgebung, einmal mit einem Produkt, das diese Daten trägt, und einmal ohne. Wie eine Staging-Umgebung für solche Tests aufgebaut ist, steht im Beitrag zu Staging-Umgebungen für sichere Updates.

Jede Mail besteht aus einem HTML-Teil und einem Klartextteil. Nach RFC 2046 sind das zwei Fassungen derselben Information, von denen das Mailprogramm die passende anzeigt (RFC 2046). Die Shopware-Dokumentation empfiehlt beide Fassungen, weil einige Mail-Provider keine HTML-Mails erlauben (Shopware-Dokumentation). Ein Pflichtinhalt, der nur im HTML-Teil steht, fehlt damit für einen Teil der Empfänger. Die Anleitung zu 6.7.15.1 nennt die Klartextfassung ausdrücklich mit (Shopware Release Notes 6.7.15.1).

Ob die Mail überhaupt im Posteingang landet, ist eine eigene Prüfung mit eigenen Werkzeugen. Sie beschreibt der Beitrag zur Zustellbarkeit von Shop-Mails.

Das Änderungsdatum in der Datenbank sagt nur, dass eine Vorlage gespeichert wurde. Es sagt nicht, was geändert wurde, von wem und auf welcher Standardfassung die Änderung aufsetzt. Genau das braucht aber, wer beim nächsten Update entscheiden muss, welche Zeilen eigene Gestaltung sind und welche nur fehlender Standard. Ohne Protokoll beginnt jeder Abgleich mit Spurensuche.

Belastbar wird das Protokoll, wenn die Vorlagen zusätzlich als Dateien in einem Repository liegen, getrennt nach Typ, Sprache und Format. Dann ist jede Änderung ein nachvollziehbarer Eintrag mit Datum, und der Vergleich mit der Fixture-Datei läuft mit denselben Werkzeugen wie jeder Code-Vergleich. Wer im Streitfall zeigen muss, welche Fassung der Bestellbestätigung ein Kunde an einem bestimmten Tag erhalten hat, findet sie dort mit Datum, statt sie aus Erinnerungen zu rekonstruieren. Welche Rechtstexte in diesem Zusammenhang gepflegt werden, beschreibt der Beitrag zur Pflege von AGB, Widerruf und Preisangaben. Die Vorlagen selbst liegen in der Datenbank des Shops; dass sie in jeder Sicherung mitlaufen, gehört zum Backup-Service.

Die Pflege angepasster Mailvorlagen ist Kleinarbeit, die selten jemandem gehört: Die Agentur hat die Vorlage einmal gestaltet, der Hoster spielt Updates ein, die Rechtsberatung liefert Texte. In unserer Shopware-Wartung gehören Changelog-Analyse und Staging-Test vor jedem Update zum Ablauf; der Abgleich der Mailvorlagen lässt sich dort als eigener Prüfpunkt aufnehmen, auch für die Sicherheitsupdates, die als Patchversion ebenfalls Vorlagen ändern können.

Wie viel Aufwand das bedeutet, hängt an der Zahl der Sprachen, Verkaufskanäle und angepassten Vorlagen. Welche Größen den Wartungsaufwand insgesamt bestimmen, zeigt der Beitrag zu den Kosten der Shop-Wartung. Die Leistungen im Überblick stehen unter Leistungen, Reaktionszeiten und Umfang im SLA-Wartungsvertrag. Wer den Bestand seiner Vorlagen zuerst sichten lassen möchte, erreicht uns über die Kontaktseite.