WERKSTATTBERICHT · PFLICHTANGABE

Gewährleistungs­label im JTL-Shop 5.7 — ohne Update auf 5.8.

Ab dem 27. September 2026 müssen Onlineshops, die an Verbraucher verkaufen, mit einer amtlichen Mitteilung der EU auf die gesetzliche Gewährleistung hinweisen. JTL-Shop bringt das ab Version 5.8 selbst mit. Für Shops, die bewusst auf 5.7 bleiben, habe ich es als Plugin gebaut — zwei Bausteine, die amtlichen Dateien unverändert, keine Datei des Templates angefasst.

JTL-Shop 5.7 Version 0.4
DIE PFLICHT

Zwei amtliche Dateien, zwei Stellen im Shop.

Eine technische Beschreibung, keine Rechtsberatung. Die rechtliche Endabnahme gehört zu Ihrer Rechtsberatung — die Leitlinien der Kommission sind eine Auslegung, nicht der Verordnungstext.

Die EU-Kommission stellt die Mitteilung zur gesetzlichen Gewährleistung als fertige Datei bereit, in allen 24 Amtssprachen. Sie muss vor dem Abschluss der Bestellung gut sichtbar sein. Online darf sie platzsparend stehen: als Satz, der die Mitteilung beim ersten Klick vollständig aufklappt — so nennen es die Leitlinien der Kommission ausdrücklich.

Gibt der Hersteller eine Garantie über die gesetzlichen zwei Jahre hinaus, kommt ein zweites Label dazu: das Garantielabel mit Marke, Modellkennung und Garantiejahren. Grundlage sind die Richtlinie (EU) 2024/825 und die Durchführungsverordnung (EU) 2025/1960.

Das Plugin bringt dafür zwei Bausteine für den OnPage Composer mit: die Mitteilung für Artikelseite und Warenkorb, das Garantielabel für die Artikelseite. Gesteuert wird aus der Wawi, über Funktionsattribute am Artikel.

DIE FALLE

Ein Baustein auf der Artikelseite gilt nur für diesen einen Artikel.

Der OnPage Composer legt für jeden Artikel eine eigene Seite an — für Variantenkinder ebenfalls. So steht es im Kern (PageService::createCurrentPageId()). Wer die Mitteilung auf der Seite von Artikel 4711 ablegt, hat sie bei Artikel 4712 nicht. Bei zwanzigtausend Artikeln ist das kein Weg.

Ich hatte das zunächst selbst anders angenommen und in der Dokumentation falsch beschrieben; aufgefallen ist es beim Nachlesen im Kern, korrigiert in Version 0.4. Seitdem gibt es eine Einstellung, die die Mitteilung auf allen Artikelseiten zeigt — ohne Composer und ohne Template-Datei. Das Plugin hängt sich an den Hook, der auf der Artikelseite nach allen Zuweisungen und vor dem Rendern läuft, und setzt die Mitteilung an die Beschreibung des Artikels. Wählbar sind vier Plätze: über oder unter der Beschreibung, über oder unter der Kurzbeschreibung.

Zwei Dinge gehören dazu. Das Stylesheet lädt der Composer nur dort, wo ein Baustein liegt — auf dem Weg über den Hook bringt das Plugin es deshalb selbst mit. Und wer beides nutzt, Einstellung und Baustein, bekommt die Mitteilung auf dieser Seite doppelt. Entweder — oder.

DER CHECKOUT

Im Checkout gibt es keinen einzigen Andockpunkt.

Wer im Backend einen Schritt des Checkouts im OnPage Composer öffnet, bekommt die Meldung, dass der Composer diesen Bereich nicht bearbeiten kann. Das ist kein Fehler: In den 22 Checkout-Vorlagen von NOVA steht kein einziger Andockpunkt, nachgezählt an JTL-Shop 5.7.2. Der Warenkorb hat fünf.

Die Leitlinien verlangen den Checkout auch nicht. Sie nennen die Produktseite, den Kopf der Website und den Checkout als Beispiele — ausdrücklich als nicht abschließende Aufzählung. Mit Artikelseite und Warenkorb steht die Mitteilung vor dem Abschluss der Bestellung, ohne dass der Checkout angefasst wird.

Wer sie trotzdem im letzten Schritt haben will, hat zwei Wege ohne Template-Eingriff: einen Eintrag in der Checkbox-Verwaltung des Shops ohne Pflichthaken, oder einen Satz im Kopf der Website, der auf eine Seite mit der Mitteilung verweist.

NACH DEN LEITLINIEN

Was die Kommission verlangt — und wie das Plugin es umsetzt

Ein Link statt des QR-Codes

Beide amtlichen Dateien tragen einen QR-Code, den am Bildschirm niemand scannen kann. Die Leitlinien verlangen deshalb immer auch einen anklickbaren Link zum selben Ziel. Im Plugin ist er fest eingebaut, für alle 24 Sprachen mit der Adresse, die die Kommission vorgibt.

Nichts hinzufügen

An der Mitteilung dürfen keine eigenen Elemente, Symbole oder Texte stehen. Ein zunächst eingebautes Info-Symbol vor dem Satz ist deshalb wieder herausgeflogen.

Farbig, in der Sprache des Shops

Online ist die farbige Fassung vorgesehen. Die Mitteilung erscheint in der Sprache, in der der Kunde den Shop sieht.

Die vorgeschriebene Schrift

Das Label verlangt die Schrift Inter. Sie liegt im Plugin, unter freier Lizenz — kein Aufruf bei Google.

Amtliche Dateien, bitgenau

Geändert wurde nur der Dateiname. Für jede Datei belegt ein SHA-256-Wert, dass der Inhalt dem der Kommission entspricht. Im Garantielabel werden genau drei Felder gefüllt: Marke, Modellkennung und Jahre.

Gesteuert aus der Wawi

Garantiejahre, Marke, Modellkennung, Link zu den Garantiebedingungen, Gebrauchtware und ein Ausschluss je Artikel — alles über Funktionsattribute. Die Namen sind mit einem verbreiteten Plugin kompatibel, gepflegte Daten bleiben nutzbar.

Bei genau zwei Jahren kein Label

Deckt die Herstellergarantie nur die gesetzlichen zwei Jahre ab, erscheint bewusst kein Garantielabel — es würde mehr verwirren als erklären.

Lesbar auf dem Handy

Eine A4-Seite ist auf 300 Pixeln Breite nicht zu lesen. Aufgeklappt steht deshalb zusätzlich ein Link, der die amtliche Datei in voller Größe öffnet — zum Zoomen.

Auch ohne Skript vollständig

Die Mitteilung klappt über ein HTML-Element auf, das jeder Browser kennt. Fällt das Skript aus, ist sie trotzdem vollständig sichtbar — eine Pflichtangabe darf nicht an einer Skriptdatei hängen.

GEMESSEN, NICHT BEHAUPTET

Geprüft, bevor es in den Shop ging

24

Amtssprachen, jede mit der Originaldatei der Kommission und der passenden Adresse des Your-Europe-Portals.

41

Seiten Praxisleitlinien der Kommission, Stand 1. April 2026, ausgewertet.

0

Andockpunkte in den 22 Checkout-Vorlagen von NOVA — nachgezählt an JTL-Shop 5.7.2.

27 KB

über die Leitung für das volle Garantielabel, 294 KB roh — die Voraussetzung dafür, es direkt in die Seite einzubetten.

375 px

Handybreite ohne waagerechtes Scrollen, im Browser gemessen.

0

geänderte Dateien im Template, kein Ausgabefilter.

Gemessen am Plugin 0.4.0 vom 16. September 2026; Zählungen im Kern an JTL-Shop 5.7.2 aus JTLs öffentlichem Repository.

OFFEN

Was ein Plugin nicht entscheiden kann

Drei Fragen bleiben, und ich schreibe sie hierhin, statt sie wegzulassen:

  • Gebrauchtware. Die amtlichen Dateien kennen keine Fassung mit einem Jahr Gewährleistung, und die Leitlinien erwähnen den Fall nicht. Das Plugin setzt bei Gebrauchtware einen eigenen Zusatzsatz unter die Mitteilung — eine Lösung, keine amtliche Vorgabe.
  • Garantiebedingungen bei Lieferung. Der Link am Label deckt den Shop ab. Ob zusätzlich etwas mit der Ware mitgehen muss, ist nicht geklärt.
  • Der Verordnungstext selbst. Die Leitlinien sind die Auslegung der Kommission. Die Endabnahme gehört zu Ihrer Rechtsberatung.
HÄUFIGE FRAGEN
Mein Shop läuft auf 5.8 — brauche ich das Plugin?+
Nein. Ab Version 5.8.0 bringt JTL-Shop die Labels selbst mit. Das Plugin ist für Shops gebaut, die auf 5.7 bleiben — etwa weil sie ein Update erst an einer Kopie prüfen, bevor es live geht. Dafür gibt es den Update-Prüfstand.
Reicht es, die Mitteilung einmal im Composer abzulegen?+
Nicht für alle Artikel: Der Composer führt jede Artikelseite als eigene Seite. Für alle Artikel auf einmal gibt es die Einstellung im Plugin, die ohne Composer arbeitet. Im Warenkorb dagegen genügt ein Baustein.
Warum erscheint das Garantielabel nicht bei jedem Artikel?+
Es erscheint nur, wenn am Artikel eine Herstellergarantie von mehr als zwei Jahren hinterlegt ist. Die Mitteilung zur gesetzlichen Gewährleistung erscheint dagegen immer — außer bei Artikeln, die Sie ausdrücklich ausnehmen.
Was passiert vor dem Stichtag?+
Vor dem eingestellten Datum zeigt das Plugin im Shop nichts; im Composer sind die Bausteine sichtbar und lassen sich vorab platzieren. Zum Prüfen gibt es einen Schalter, der sie früher einblendet.
Wie kommt das Plugin in meinen Shop?+
Als Paket, das im Backend unter Plugins hochgeladen wird. Danach die Einstellungen prüfen und entweder die Bausteine ablegen oder die Einstellung für alle Artikelseiten wählen. Sprechen Sie mich an.
PASST DAZU

Mehr aus der Entwicklung

KONTAKT

Ihr Shop bleibt auf 5.7, und die Mitteilung fehlt noch?

Dann lässt sie sich ohne Eingriff ins Template nachrüsten. Schreiben Sie mir, auf welcher Version Ihr Shop läuft.

4VEX.

Individuelle Software und Werkzeuge für Betriebe, die mit Standardlösungen an Grenzen stoßen.

© 2026 4VEX<EX/>