In Shopware 6 setzen Sie den Platzhalter über die Erlebniswelten in das Layout der Produktseite. Das Skript laden Sie über das Theme oder ein Plugin für eigene Skripte, denn seit Shopware 6.5 entfernt der Editor Skripte aus Text-Elementen.
Neu seit Shopware 6.7.14 (und 6.6.10.24): Shopware bringt das GARAN-Label selbst mit. Sie pflegen die Garantiedauer am Produkt, Marke und Modellkennung kommen aus Hersteller und Hersteller-Produktnummer. Das Widget ergänzt den Gewährleistungshinweis auf der Produktseite. Lassen Sie dann data-garan-* im Widget weg, damit das GARAN-Label nicht doppelt erscheint. Details unten unter „Varianten und Modellkennung“.
Der Code für Shopware 6
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>Weitere Optionen wie Darstellung und Sprache stellen Sie im Code-Baukasten ein.
Schritt für Schritt in Shopware 6
- Erlebniswelt öffnen
In der Administration unter Inhalte → Erlebniswelten das Layout Ihrer Produktseiten öffnen oder ein neues vom Typ „Produktseite“ anlegen. - Platzhalter einfügen
Unter dem Kaufbereich einen Block mit einem Text-Element einfügen, in die Quellcode-Ansicht wechseln und<div data-garantielabel></div>einsetzen. - Skript laden
Die Zeile mitwidget.jsüber das Theme (z. B. inbase.html.twig) oder ein Plugin für eigene Skripte einbinden, dann das Layout speichern und den Produkten zuweisen. - Alternative im Theme
Entwickler erweitern im eigenen Theme die Vorlage des Kaufbereichs (buy-widget.html.twig) um den Platzhalter und binden das Skript im Template-Kopf ein.
Besonderheiten in Shopware 6
- Shopware ab 6.5 filtert Skripte im Text-Element (HTML-Sanitizer). Abschalten lässt sich das nur bei selbst gehosteten Shops; in der Shopware Cloud bleibt der Weg über Theme oder Plugin.
- Bei eigener Content-Security-Policy muss
www.garantielabel.appfür Skripte, Bilder und Verbindungen erlaubt sein.
Wo der Hinweis in Shopware 6 hingehört
Die Produktseite ist in Shopware eine Erlebniswelt vom Typ „Produktseite“. Im Standard enthält sie die Buybox mit Produktbildgalerie und die Produktbeschreibung. Dazu kommen Elemente wie „Produktname & Hersteller-Logo“ und Cross Selling. Ein Layout weisen Sie im Produkt im Reiter Layout zu. Als Standard für neue Produktseiten legen Sie es in der Seitenleiste unter Layout-Zuweisung → Standardlayouts fest.
Im Theme stammt die Buybox aus der Vorlage buy-widget.html.twig, in Shopware 6.7 unter storefront/component/buy-widget/. Eigene Vorlagen legen Sie im Plugin oder Theme unter Resources/views mit derselben Ordnerstruktur an und erweitern das Original mit sw_extends.
Für den Seitenfuß wählen Sie in den Einstellungen des Verkaufskanals den „Einstiegspunkt für die Footer-Navigation“. Die Ebene darunter liefert im Standard-Theme die Überschriften, die Ebene darunter die Links. Entwickler erweitern stattdessen die Vorlage layout/footer/footer.html.twig und setzen dort das Widget mit data-darstellung="link" ein.
Varianten, Hersteller-Produktnummer und GARAN-Label
Varianten legen Sie im Produkt im Reiter Varianten mit dem Variantengenerator an. Vorher brauchen Sie Eigenschaften unter Produkte → Eigenschaften. Varianten erben Angaben wie Name und Beschreibung vom Hauptprodukt. Mit dem Ketten-Symbol heben Sie die Vererbung für eine Variante auf.
Seit Shopware 6.7.14 und 6.6.10.24 zeigt Shopware das GARAN-Label selbst an. Im Produkt gibt es dafür die Karte „Garantie (GARAN Label)“ mit der „Dauer der herstellerseitigen Garantie in Monaten“ (30 bis 600, in Schritten von 6) und dem Schalter „Label in der Storefront anzeigen“. Die Marke kommt aus dem Feld Hersteller, die Modellkennung aus der „Hersteller-Produktnummer“ im Reiter Allgemein. Fehlt eine Angabe, zeigt Shopware kein Label. Laut Shopware lassen sich die Garantiefelder am Hauptprodukt pflegen und je Variante überschreiben. Haben Ihre Varianten eigene Modellkennungen, tragen Sie die Hersteller-Produktnummer je Variante ein.
Das GARAN-Label erscheint dann unter der Buybox, im Warenkorb, auf der Bestellabschlussseite und in der Bestellbestätigung. Den Gewährleistungshinweis verlinkt Shopware auf der Bestellabschlussseite beim AGB-Text. Eine Anzeige auf der Produktseite beschreibt Shopware nicht, dort und im Footer ergänzt das Widget den Hinweis. Nutzt Ihr Shop das eingebaute GARAN-Label, lassen Sie data-garan-voll und data-garan-klein im Widget weg, sonst steht das Label doppelt da.
Typische Stolpersteine in Shopware
- Cache: Nach Änderungen an Vorlagen leeren Sie den Cache, etwa mit
bin/console cache:clear. Das Theme muss im Reiter Theme dem richtigen Verkaufskanal zugewiesen sein. - Angepasste Bestellmail: Das Update hat die Vorlage der Bestellbestätigung nur ergänzt, wenn sie nie bearbeitet wurde. Angepasste Vorlagen bekommen GARAN-Label und Hinweis-Link laut Shopware nicht automatisch.
- Überschriebener AGB-Text: Der Link zum Gewährleistungshinweis ist nach dem Update eingeschaltet („Gewährleistungshinweis auf Bestellabschlussseite anzeigen“). Wer den AGB-Text der Bestellabschlussseite im Theme überschrieben hat, muss die Anpassung laut Shopware nachziehen.
- Mehrere Verkaufskanäle: Die Einstellung zum Gewährleistungshinweis lässt sich je Verkaufskanal überschreiben. Prüfen Sie jeden Kanal einzeln.
Weitere Quellen
- Shopware: GARAN label and EU guarantee requirements (englisch)
- Shopware-Changelog 6.6.10.24: EU harmonised guarantee label (GitHub)
- Shopware-Release 6.7.14.0 (GitHub)
- Shopware-Vorlage buy-widget.html.twig (GitHub)
- Shopware-Doku: Erlebniswelten
- Shopware-Doku: Produkte
- Shopware-Doku: Verkaufskanäle
- Shopware-Entwickler-Doku: Customize templates (englisch)
Gewährleistungslabel in der Bestellbestätigung
Laut Leitlinien der Kommission soll der Hinweis auch in der Bestätigungs-E-Mail stehen. Mail-Vorlagen bearbeiten Sie in Shopware unter Einstellungen → E-Mail-Templates. In der Vorlage zur Bestellbestätigung lässt sich die amtliche Grafik als Bild ergänzen. Ein bloßer Link reicht als dauerhafter Datenträger voraussichtlich nicht (EuGH, Rs. C-49/11); am sichersten steht der Hinweis als Bild, Text oder Anhang direkt in der Mail. Die amtlichen Dateien finden Sie im Download.
Herstellergarantie? Dann gehört das GARAN-Label dazu
Gibt der Hersteller eine kostenlose Haltbarkeitsgarantie von mehr als zwei Jahren auf die ganze Ware, gehört zusätzlich das GARAN-Label auf die Produktseite. Mit dem GARAN-Label-Generator erstellen Sie es in Sekunden aus Jahren, Marke und Modell, die ersten drei kostenlos und ohne Anmeldung. Unter jedem fertigen Label steht ein Einbett-Code mit dauerhaften Bild-Adressen: Sie laden nichts hoch und setzen ihn wie oben in Shopware 6 ein.
Lieber eigene Dateien? Dann laden Sie die vollständige und die geschachtelte Fassung in die Medienverwaltung von Shopware 6 und tragen die Adressen im Widget-Code ein:
<div data-garantielabel
data-garan-voll="https://…/GARAN-MX-500.svg"
data-garan-klein="https://…/GARAN-MX-500-geschachtelt.svg"></div>Das Widget zeigt dann die geschachtelte Fassung unter dem Gewährleistungslabel, ein Klick öffnet das vollständige GARAN-Label.
Häufige Fragen
Geht das auch in Shopware 5?
Ja, über ein Einkaufswelt-Element oder die Template-Datei der Detailseite. Shopware 5 wird allerdings seit Juli 2024 nicht mehr unterstützt.
Muss ich das für jedes Produkt einzeln machen?
Nein. Im Layout der Produktseite gilt der Code für alle Produkte, denen das Layout zugewiesen ist.
Stört das den Kaufbereich?
Nein. Das Widget zeichnet nur in seinen Platzhalter und verändert nichts außerhalb.
Brauche ich das Widget, wenn Shopware das GARAN-Label schon zeigt?
Für das GARAN-Label nicht. Ab Shopware 6.7.14 bzw. 6.6.10.24 übernimmt Shopware das selbst. Den Gewährleistungshinweis verlinkt Shopware auf der Bestellabschlussseite. Für Produktseite und Footer bleibt das Widget sinnvoll, dann ohne data-garan-….
Welches Feld nimmt Shopware als Modellkennung?
Die Hersteller-Produktnummer im Reiter Allgemein. Die Marke kommt aus dem Feld Hersteller.
Warum zeigt Shopware kein GARAN-Label?
Shopware zeigt es nur, wenn „Label in der Storefront anzeigen“ eingeschaltet ist und Garantiedauer, Hersteller und Hersteller-Produktnummer gepflegt sind.