Ratgeber · JTL-Shop SEO
JTL-Shop 5 Update sicher durchführen: Schritt für Schritt
Ein JTL-Shop 5 Update machst du in fünf Schritten: Wartungsmodus an und alles sichern, neue Dateien per FTP hochladen, im Backend das Datenbank-Update starten, verwaiste Dateien löschen und zum Schluss Plugins, Template und Kaufprozess testen. Plane dafür eine ruhige Stunde ein und halte den Abgleich mit der JTL-Wawi so lange an.
Ein Update von JTL-Shop 5 ist kein großes Projekt, wenn du es vorbereitest. Die meisten Probleme entstehen nicht beim Hochladen, sondern davor und danach: ein überschriebenes Template, ein Plugin, das mit der neuen Version nicht läuft, oder ein Wawi-Abgleich, der mitten ins Update funkt. Diese Anleitung folgt dem offiziellen Ablauf aus dem JTL-Guide und ergänzt ihn um die Punkte, die im Alltag am häufigsten schiefgehen.
Welche Arten von Updates gibt es bei JTL-Shop 5?
Bei JTL-Shop 5 unterscheidest du Build-Updates (Patch, z. B. 5.4.1 auf 5.4.2) und Minor-Updates (z. B. 5.4 auf 5.5). Ein Build-Update bringt Fehler- und Sicherheitskorrekturen, meist ohne große Datenbankänderung. Ein Minor-Update bringt neue Funktionen und oft Änderungen an Datenbank und Template.
| Art | Beispiel | Inhalt | Lizenz | Risiko |
|---|---|---|---|---|
| Build/Patch | 5.4.1 → 5.4.2 | Fehler- und Sicherheitskorrekturen | Kein aktives Abo nötig | gering |
| Minor | 5.4 → 5.5 | Neue Funktionen, Datenbank- und Template-Änderungen | Gültige Lizenz mit aktivem Abo | mittel |
| Upgrade von Version 4 | 4.06 → 5 | Neues System, neues Template, neue Plugins | Lizenzschlüssel gilt weiter | hoch, eigenes Projekt |
Wichtig: Wer JTL-Shop im Hosting von JTL betreibt, aktualisiert nicht selbst. Dort merkst du das Update im Kundencenter vor, und JTL spielt es an einem Werktag ein. Die Anleitung unten gilt für Shops auf eigenem Webspace.
Was musst du vor dem Update vorbereiten?
Vor dem Update schaltest du den Wartungsmodus ein, hältst den Abgleich mit der JTL-Wawi an und sicherst Dateien und Datenbank. Das ist der wichtigste Teil, denn nur mit einer frischen Sicherung kannst du im Notfall zurück.
- Termin wählen: Nimm eine Zeit mit wenig Bestellungen, zum Beispiel früh morgens. Nicht vor einem Aktionstag oder einem Newsletter-Versand.
- Versionshinweise lesen: Lies im JTL-Forum die Hinweise zu jeder Version, die du überspringst. Dort steht auch, welche PHP-Version nötig ist.
- Wartungsmodus einschalten: In den globalen Einstellungen des Backends. Kunden sehen dann eine Hinweisseite, du selbst kommst als Admin weiter in den Shop.
- Wawi-Abgleich anhalten: Stoppe den Abgleich mit der JTL-Wawi und, falls du ihn nutzt, den JTL-Worker. Ein Abgleich während des Datenbank-Updates kann Daten beschädigen.
- Objekt-Cache ausschalten: Unter Administration → System → Cache.
- Plugins aufräumen: Deinstalliere Plugins, die du nicht mehr brauchst, und lösche ihre Ordner. Die übrigen deaktivierst du. Notiere vorher, welche Plugins aktiv waren.
- Alles sichern: Sichere alle Shop-Dateien, vor allem den Ordner
/templates/und die Datei/includes/config.JTL-Shop.ini.php, und die Datenbank. Viele Hoster bieten dafür im Kundenmenü eine Sicherung per Knopfdruck.
/templates/NOVA und /templates/Evo komplett überschrieben. Wer direkt im NOVA-Ordner Änderungen gemacht hat, verliert sie. Eigene Anpassungen gehören in ein Child-Template, zum Beispiel NOVAChild. Dann bleiben sie beim Update erhalten, und du prüfst danach nur, ob sie zur neuen NOVA-Version passen.Wie führst du das JTL-Shop 5 Update Schritt für Schritt durch?
Das eigentliche Update besteht aus zwei Teilen: Dateien hochladen und Datenbank aktualisieren. Beides zusammen dauert meist 15 bis 30 Minuten.
Dateien hochladen
- Paket laden: Melde dich im JTL-Kundencenter an und lade unter Produkte → Onlineshop → Shop Editionen das Installationspaket der neuen Version herunter.
- Paket vorbereiten: Entpacke es auf deinem Rechner. Lösche den Ordner
installund die Dateishopinfo.xml. - Eigene Einstellungen übernehmen: Hast du
.htaccess,admin/.htaccessoderrobots.txtangepasst, trag deine Änderungen in die neuen Dateien aus dem Paket ein. Nicht einfach die alten Dateien behalten, denn neue Versionen ändern diese Dateien manchmal. - Hochladen: Lade alles per FTP im Binärmodus hoch, Ordner zusammenführen, vorhandene Dateien überschreiben. Prüfe im FTP-Programm, ob Übertragungen fehlgeschlagen sind.
Datenbank aktualisieren
- Anmelden: Melde dich im Backend an. Meist landest du direkt im Update-Menü, sonst unter Administration → System → Update. JTL empfiehlt die Anmeldung im abgesicherten Modus (im Anmeldefenster unter „Erweitert“), dann laden keine Plugins.
- Zweite Sicherung: Optional legst du hier noch eine Sicherungskopie der Datenbank an. Sie landet im Ordner
/export/backup. - Update starten: Starte das Datenbank-Update und warte, bis es fertig ist. Fenster nicht schließen.
- Bei einem Fehler: Mach ein Bildschirmfoto der Meldung und wende dich an den JTL-Support oder deinen Servicepartner. Spiel nicht einfach die alten Dateien zurück, denn Dateien und Datenbank müssen zusammenpassen.
Was musst du nach dem Update prüfen?
Nach dem Update löschst du verwaiste Dateien, bringst die Plugins auf den neuen Stand und testest den Kaufprozess, bevor du den Wartungsmodus ausschaltest.
- Verwaiste Dateien: Unter Administration → Fehlerbehebung → Diagnose zeigt die Dateistruktur Dateien, die es in der neuen Version nicht mehr gibt. Lösche sie. Alte Dateien können Sicherheitslücken enthalten.
- Diagnose: Lass auf derselben Seite die Prüfungen laufen und arbeite Warnungen ab.
- Plugins: Unter Plugins → Meine Käufe alle Plugins aktualisieren, danach in der Plugin-Verwaltung ausstehende Updates installieren. Aktiviere die Plugins einzeln wieder. Taucht ein Fehler auf, weißt du so gleich, welches Plugin ihn verursacht.
- Template: Vergleiche dein Child-Template mit der neuen NOVA-Version. Sieh dir Startseite, Kategorie, Artikel, Warenkorb und Kasse auf dem Handy und am Rechner an.
- E-Mail-Vorlagen: Sie werden nicht automatisch aktualisiert. Sichere deine eigenen Texte, setze die Vorlagen unter Administration → E-Mails → Vorlagen zurück und trag deine Änderungen wieder ein.
- Testkauf: Registriere ein Testkonto und kaufe einmal bis zur Bestellbestätigung. Prüfe, ob die Bestellmail ankommt.
- Freigeben: Wartungsmodus aus, Wawi-Abgleich und JTL-Worker wieder starten, Objekt-Cache wieder einschalten.
- Beobachten: In den ersten Tagen das Systemlog, die Bestellungen und das E-Mail-Log im Blick behalten.
Auch für die Suchmaschine lohnt ein kurzer Blick: Stimmen Titel und Meta-Beschreibungen noch, gibt es neue 404-Fehler, ist die Sitemap erreichbar? Die Punkte stehen in der JTL-Shop SEO Checkliste, neue 404-Adressen behandelt der Ratgeber 404 und Weiterleitungen.
Welche Fehler passieren beim JTL-Shop Update am häufigsten?
Die häufigsten Fehler sind vergessene Sicherungen, Änderungen direkt im NOVA-Template, laufender Wawi-Abgleich und Plugins, die nicht zur neuen Version passen.
| Fehler | Folge | So vermeidest du ihn |
|---|---|---|
| Keine frische Sicherung | Kein Weg zurück bei einem Fehler | Dateien und Datenbank direkt vor dem Update sichern |
| Änderungen direkt in NOVA | Anpassungen nach dem Update weg | Eigene Änderungen nur im Child-Template |
| Wawi-Abgleich läuft weiter | Abgebrochenes Update, fehlerhafte Daten | Abgleich und JTL-Worker vorher anhalten |
| Alle Plugins auf einmal aktiviert | Weiße Seite, Ursache unklar | Plugins einzeln aktivieren |
| Alte .htaccess behalten | Fehlende Regeln der neuen Version | Eigene Zeilen in die neue Datei übernehmen |
| PHP-Version zu alt | Shop startet nicht | Systemvoraussetzungen vorher prüfen, PHP beim Hoster umstellen |
| Versionen übersprungen, ohne Hinweise zu lesen | Unerwartete Änderungen | Hinweise jeder übersprungenen Version lesen |
Wie hilft die KI-Brücke beim Update?
Mit der Shoplotse KI-Brücke fragt dein KI-Assistent den Shop vor und nach dem Update ab und vergleicht beide Stände. So musst du keine Bildschirmfotos machen und siehst Abweichungen sofort.
- Vorher: „Wie steht mein Shop gerade da?“ Das Werkzeug
shop_statusnennt Shop-Version, PHP-Version, Template mit Version, ob der Wartungsmodus an ist, und Plugins mit Fehlern.plugins_listeliefert alle Plugins mit Version und Status. - Nachher: Dieselbe Frage noch einmal. Die KI vergleicht und meldet zum Beispiel ein Plugin mit dem Status „Update fehlgeschlagen“ oder eines, das vorher aktiv war und jetzt fehlt.
- In den Tagen danach:
statistikundkaufabbruechezeigen, ob Bestellungen normal weiterlaufen oder plötzlich mehr Kunden in der Kasse abbrechen. Das ist oft das erste Zeichen, dass ein Zahlungs-Plugin nach dem Update hakt.
Wie du Claude mit dem Shop verbindest, steht im Ratgeber Claude per MCP mit JTL-Shop verbinden, alle Werkzeuge in der Doku der KI-Brücke.
Checkliste: JTL-Shop 5 Update
Mit dieser Checkliste vergisst du beim nächsten Update keinen Schritt.
- Versionshinweise und PHP-Voraussetzungen gelesen
- Ruhigen Termin gewählt
- Wartungsmodus an
- Wawi-Abgleich und JTL-Worker angehalten
- Objekt-Cache aus
- Nicht genutzte Plugins entfernt, übrige deaktiviert und notiert
- Dateien und Datenbank gesichert
- Paket ohne
installundshopinfo.xmlhochgeladen, eigene .htaccess-Zeilen übernommen - Datenbank-Update gelaufen
- Verwaiste Dateien gelöscht, Diagnose ohne Warnungen
- Plugins aktualisiert und einzeln aktiviert
- Template und E-Mail-Vorlagen geprüft
- Testkauf mit Bestellmail erfolgreich
- Wartungsmodus aus, Abgleich und Cache wieder an
So hilft dir Shoplotse
Die Shoplotse KI-Brücke nimmt dir beim Update das Abschreiben ab: Ein Satz im Chat zeigt Version, Template und alle Plugins vor dem Update, ein zweiter nach dem Update, und die KI sagt dir, was sich geändert hat. Danach behält sie Bestellungen und Kaufabbrüche im Blick. Sie ändert dabei nichts am Shop, das Update selbst machst du oder dein Servicepartner. Welche Aufgaben die KI sonst übernimmt, zeigt der Ratgeber JTL-Shop mit KI steuern.
Fragen und Antworten
Wie lange dauert ein JTL-Shop 5 Update?
Hochladen und Datenbank-Update dauern meist 15 bis 30 Minuten. Mit Sicherung, Plugin-Prüfung und Testkauf solltest du ein bis zwei Stunden einplanen.
Brauche ich für ein JTL-Shop Update ein aktives Abo?
Für Minor-Updates, etwa von 5.4 auf 5.5, brauchst du eine gültige Lizenz mit aktivem Abo. Build- oder Patch-Updates innerhalb einer Version gehen laut JTL auch ohne aktives Abo.
Gehen beim Update meine Template-Anpassungen verloren?
Änderungen direkt im Ordner NOVA oder Evo gehen verloren, weil diese Ordner überschrieben werden. Anpassungen in einem Child-Template wie NOVAChild bleiben erhalten.
Muss ich den Wawi-Abgleich während des Updates stoppen?
Ja. Halte den Abgleich mit der JTL-Wawi und den JTL-Worker an, bis das Update fertig ist und der Shop geprüft ist. Ein Abgleich während des Datenbank-Updates kann zu fehlerhaften Daten führen.
Was mache ich, wenn das Datenbank-Update einen Fehler meldet?
Mach ein Bildschirmfoto der Meldung und wende dich an den JTL-Support oder einen Servicepartner. Spiel nicht einfach die alten Dateien zurück, weil Dateien und Datenbank zusammenpassen müssen. Mit der Sicherung von vorher lässt sich der alte Stand komplett wiederherstellen.
Kann ich mehrere Versionen auf einmal überspringen?
Ja, das Update-Menü spielt die nötigen Datenbankschritte nacheinander ein. Lies aber die Hinweise zu jeder übersprungenen Version, denn dort stehen Änderungen an PHP-Voraussetzungen, Template und Plugins.
Weiterlesen
- JTL-Shop SEO Checkliste
- 404 und Weiterleitungen
- Google Search Console
- SEO mit KI
- SEO für Onlineshops
- GA4 im JTL-Shop 5
- JTL-Shop mit KI verbinden
- Alle Ratgeber
Stand: 9.11.2026. Angaben zu JTL und Google ohne Gewähr, Menüs können sich mit neuen Versionen ändern.