--- title: "WooCommerce-Updates sicher einspielen: Datenbank-Update und Vorlagen prüfen" date: 2026-09-30T22:55:14+02:00 modified: 2026-10-23T22:06:59+02:00 category: wordpress type: how_to author: Marcel Schönfelder canonical: https://s-edv.com/anleitungen/wordpress-woocommerce-updates-sicher-einspielen-datenbank-vorlagen keywords: - WordPress - WooCommerce - Updates - Onlineshop - WP-CLI reading_time: 9 --- # WooCommerce-Updates sicher einspielen: Datenbank-Update und Vorlagen prüfen Ein WooCommerce-Update ist mehr als ein Plugin-Update. Neben den Dateien ändert WooCommerce bei vielen Versionen auch die Struktur seiner Datenbank, und Themes bringen oft eigene Kopien von WooCommerce-Vorlagen mit, die nach dem Update veralten können. Beides fällt im Alltag kaum auf, bis im Shop ein Preis fehlt, eine Bestellmail seltsam aussieht oder der Checkout hakt. Diese Anleitung zeigt einen Ablauf, mit dem Sie WooCommerce-Updates in einem kleinen Shop planbar einspielen: Sicherung, Kompatibilität prüfen, Update, Datenbank-Update und die Kontrolle überschriebener Vorlagen. **Kurzfassung:** Sichern Sie Dateien und Datenbank und spielen Sie große Versionssprünge zuerst auf einer Staging-Kopie ein. Nach dem Update des Plugins steht oft ein Datenbank-Update an, das Sie im Backend über den Hinweis oder per `wp wc update` ausführen. Prüfen Sie danach unter **Werkzeuge > Website-Zustand** und im WooCommerce-Systemstatus, ob Ihr Theme veraltete Vorlagen enthält. Testen Sie zum Schluss eine echte Bestellung vom Warenkorb bis zur Bestellmail. ## Voraussetzungen - [ ] WordPress und PHP in den Versionen, die die aktuelle WooCommerce-Version verlangt. Laut der mitgelieferten `readme.txt` setzt WooCommerce 11.2.1 WordPress 7.0 und PHP 7.4 voraus. Ab WooCommerce 11.6, geplant für Februar 2027, verlangt WooCommerce laut [Entwicklerblog](https://developer.woocommerce.com/2026/09/29/php-8-1-requirement/) PHP 8.1 oder neuer. Getestet wurde mit WordPress 7.1.2 und PHP 8.4. - [ ] Die Rolle Administrator im Backend. - [ ] Zugriff auf die Dateien per SFTP oder SSH, für die Befehle in dieser Anleitung außerdem WP-CLI. - [ ] Ein aktuelles, geprüftes Backup von Dateien und Datenbank. Bei einem Shop mit laufenden Bestellungen ist das keine Formalität: Ein Zurückspielen löscht alle Bestellungen seit der Sicherung. - [ ] Möglichst eine Staging-Kopie des Shops, auf der Sie das Update vorab ausprobieren. ## Schritt 1: Zeitpunkt wählen und Stand erfassen Spielen Sie Updates in einer ruhigen Zeit ein, etwa früh am Morgen, und nicht kurz vor einer Aktion oder am Freitagnachmittag. Erfassen Sie vorher den Ist-Zustand, damit Sie nach dem Update vergleichen können: ```bash $ wp plugin list --fields=name,status,version,update_version $ wp option get woocommerce_version $ wp option get woocommerce_db_version ``` `woocommerce_version` ist die Version der Plugin-Dateien, `woocommerce_db_version` der Stand der Datenbank. Im Normalbetrieb sind beide gleich. Laufen sie auseinander, wurde ein Datenbank-Update noch nicht ausgeführt. Lesen Sie außerdem die Änderungshinweise der neuen Version. Wie Sie Changelogs einschätzen, beschreibt die Anleitung [WordPress-Updates prüfen und das Risiko einschätzen](https://s-edv.com/anleitungen/wordpress-updates-pruefen-changelog-risiko-einschaetzen). > **Prüfen:** Sie haben die Liste der Plugins mit Versionen und die beiden Versionswerte notiert, zum Beispiel in Ihrer Website-Dokumentation. ## Schritt 2: Erweiterungen und Theme auf Kompatibilität prüfen Zahlungs-, Versand- und Rechnungs-Plugins hängen eng an WooCommerce. Viele Erweiterungen geben im Kopf ihrer Hauptdatei an, mit welcher WooCommerce-Version sie getestet wurden, über die Angaben `WC requires at least` und `WC tested up to`. Prüfen Sie außerdem, ob für Ihre Erweiterungen und Ihr Theme selbst Updates bereitstehen, und spielen Sie diese in der vom Hersteller empfohlenen Reihenfolge ein. Wie wichtig die Reihenfolge ist, zeigt ein Hinweis in den Release Notes von WooCommerce 11.2.0: PublishPress Future in den Versionen 3.0.0 bis 4.10.3 lädt eine eigene, veraltete Kopie des Action Schedulers und kann mit WooCommerce 11.2 einen fatalen Fehler auslösen. Behoben ist das laut den Release Notes ab Version 4.10.4, die Erweiterung gehört also vor WooCommerce aktualisiert. Im Test lieferte die Startseite nach dem Update von WooCommerce 11.1.2 auf 11.2.1 mit PublishPress Future 4.10.3 den Status 500, im Debug-Protokoll stand: ```plaintext PHP Fatal error: Declaration of PublishPress\Future\Modules\Expirator\Tables\ScheduledActionsTable::column_hook(array $row) must be compatible with ActionScheduler_ListTable::column_hook($row) in /var/www/html/wp-content/plugins/post-expirator/src/Modules/Expirator/Tables/ScheduledActionsTable.php on line 401 ``` Auch `wp plugin update post-expirator` brach mit diesem Fehler ab. Erst `wp --skip-plugins=post-expirator plugin update post-expirator` brachte die Erweiterung auf 4.11.1, danach lud die Startseite wieder. Bei Premium-Erweiterungen, die nicht aus dem Verzeichnis auf wordpress.org stammen, brauchen Sie eine gültige Lizenz, um Updates zu erhalten. Ist eine Lizenz abgelaufen, bleibt die Erweiterung auf dem alten Stand, während WooCommerce weiterzieht. Genau diese Kombination führt häufig zu Fehlern. > **Prüfen:** Für jede aktive WooCommerce-Erweiterung wissen Sie, ob sie mit der Zielversion getestet ist oder ob der Hersteller ein passendes Update anbietet. ## Schritt 3: Backup erstellen Sichern Sie direkt vor dem Update die Datenbank und den Ordner `wp-content`. Per WP-CLI geht der Datenbankteil in wenigen Sekunden: ```bash $ mkdir -p ~/backups $ wp db export ~/backups/vor-woocommerce-update-$(date +%F-%H%M).sql ``` Legen Sie die Datei außerhalb des Webordners ab, weil sie Kundendaten und Bestellungen enthält. Aus Datenschutzsicht gilt für diese Sicherung dasselbe wie für die Live-Datenbank: Nach dem erfolgreichen Update löschen Sie sie oder übernehmen sie in Ihre reguläre Backup-Aufbewahrung. Ein Datenbank-Update von WooCommerce lässt sich nicht rückgängig machen, das Zurückspielen dieser Sicherung ist der einzige Weg zurück. Mehr zu Aufbewahrung und Rücksicherung finden Sie in der Anleitung [WordPress-Datenbank mit WP-CLI sichern und wiederherstellen](https://s-edv.com/anleitungen/wordpress-datenbank-wp-cli-sichern-wiederherstellen). > **Prüfen:** `wp db export` meldet `Success: Exported to '…'.`, und die Datei ist größer als null Byte. ## Schritt 4: WooCommerce aktualisieren Im Backend aktualisieren Sie WooCommerce unter **Dashboard > Aktualisierungen** oder unter **Plugins > Installierte Plugins**. Per WP-CLI lautet der Befehl: ```bash $ wp plugin update woocommerce ``` Aktualisieren Sie WooCommerce einzeln und nicht zusammen mit allen anderen Plugins. Tritt ein Fehler auf, wissen Sie so sofort, woher er kommt. Im Test sprang eine Installation von Version 9.9.5 auf 11.2.1. Danach stand `woocommerce_version` auf 11.2.1, `woocommerce_db_version` aber weiter auf 9.9.5. Das Plugin war aktualisiert, die Datenbank noch nicht. > **Prüfen:** `wp plugin list --name=woocommerce` zeigt die neue Version, und der Shop lädt im Frontend ohne Fehlermeldung. ## Schritt 5: Datenbank-Update ausführen Steht ein Datenbank-Update an, blendet WooCommerce im Backend den Hinweis „Aktualisierung der WooCommerce-Datenbank erforderlich“ mit der Schaltfläche **WooCommerce-Datenbank aktualisieren** ein. Nach dem Klick läuft das Update laut WooCommerce im Hintergrund und kann etwas dauern. Bei großen Shops ist die Kommandozeile zuverlässiger, weil sie nicht von Hintergrundaufgaben und Seitenaufrufen abhängt: ```bash $ wp wc update $ wp option get woocommerce_db_version ``` Im Test fand WooCommerce 31 ausstehende Aktualisierungen und meldete danach `Success: 31 Aktualisierungen abgeschlossen. Die Datenbankversion ist 11.2.1`. Von 11.1.2 auf 11.2.1 waren es neun, weil WooCommerce 11.2.0 laut Release Notes ein Datenbank-Update mitbringt. Diese Schritte ändern unter anderem Indizes, Optionen und Einstellungen. Deshalb verlangt Schritt 3 die Sicherung davor. Alternativ finden Sie die Aufgabe im Backend unter **WooCommerce > Status > Werkzeuge** als **Datenbank aktualisieren**. > **Prüfen:** `woocommerce_db_version` entspricht der neuen Plugin-Version, und der Hinweis auf ein Datenbank-Update ist im Backend verschwunden. ## Schritt 6: Überschriebene Vorlagen prüfen Themes können WooCommerce-Vorlagen überschreiben, indem sie Kopien im Ordner `woocommerce` des Themes ablegen, etwa `woocommerce/emails/email-footer.php`. Jede Vorlage trägt im Kopf eine Zeile `@version`. Ändert WooCommerce eine Vorlage, steigt diese Nummer, die Kopie im Theme bleibt aber alt. Die Folge können fehlende Felder, Darstellungsfehler oder PHP-Warnungen sein. WooCommerce meldet das an zwei Stellen. Unter **Werkzeuge > Website-Zustand** erscheint die Empfehlung, dass Ihr Theme veraltete WooCommerce-Template-Überschreibungen enthält, mit dem Link **Betroffene Templates anzeigen**. Unter **WooCommerce > Status** im Systemstatus listet der Abschnitt zum Theme alle Überschreibungen mit Theme-Version und Plugin-Version. Im Test hatten wir zwei Vorlagen in ein Child-Theme kopiert. Nach dem Update war `email-footer.php` im Theme auf Stand 9.6.0, im Plugin auf 10.4.0, und der Website-Zustand zeigte genau diese Empfehlung. Die zweite Kopie blieb unverändert gültig, weil WooCommerce sie nicht geändert hatte. Ein aktuelles Beispiel ist `single-product/meta.php`: Mit WooCommerce 11.2.0 stieg ihre Version von 9.7.0 auf 11.2.0, und eine Kopie aus 11.1.2 meldete der Website-Zustand nach dem Update als veraltet. Die WooCommerce-Dokumentation beschreibt die Korrektur so: die veraltete Kopie sichern, die aktuelle Vorlage aus `wp-content/plugins/woocommerce/templates/` an dieselbe Stelle im Theme kopieren und Ihre eigenen Änderungen erneut einarbeiten. Ein Vergleich der alten und neuen Datei zeigt, was sich geändert hat: ```bash cd wp-content cp themes/IHR-THEME/woocommerce/emails/email-footer.php ~/backups/email-footer.php.alt diff ~/backups/email-footer.php.alt plugins/woocommerce/templates/emails/email-footer.php ``` Stammt die Überschreibung von einem gekauften Theme, bringt oft ein Update des Themes die neue Fassung mit. Fragen Sie in diesem Fall zuerst den Theme-Hersteller. > **Prüfen:** Im Website-Zustand erscheint die Prüfung „WooCommerce-Template-Überschreibungen“ nicht mehr unter den Empfehlungen, und im Systemstatus stimmen Theme- und Plugin-Version jeder Vorlage überein. Der Systemstatus speichert die Theme-Angaben bis zu einer Stunde zwischen. Im Test zeigte er die neue Version erst nach `wp transient delete wc_system_status_theme_info`, der Website-Zustand dagegen sofort. ## Schritt 7: Shop durchtesten Technische Prüfungen ersetzen keinen echten Durchlauf. Legen Sie im Frontend ein Produkt in den Warenkorb, gehen Sie zur Kasse und schließen Sie eine Bestellung mit einer Testzahlart ab, etwa Vorkasse. Prüfen Sie danach, ob die Bestellbestätigung per E-Mail ankommt und richtig aussieht, ob die Bestellung im Backend unter **WooCommerce > Bestellungen** erscheint und ob Ihr Rechnungs-Plugin eine Rechnung erzeugt. Stornieren Sie die Testbestellung anschließend. Diese Kontrolle wiederholt sich bei jedem Update, und WooCommerce erscheint in kurzen Abständen. Wer das nicht selbst im Kalender halten möchte, kann es abgeben: Die [WordPress-Wartung von wordpressupdate.de](https://wordpressupdate.de/?utm_source=s-edv.com&utm_medium=artikel&utm_campaign=124) spielt Updates von WordPress, Plugins und Themes mit Kompatibilitätsprüfung ein und sichert die Website wöchentlich auf externen Speicher. > **Prüfen:** Die Testbestellung lief vom Warenkorb bis zur E-Mail durch, und unter **WooCommerce > Status > Protokolle** finden sich keine neuen Fehlereinträge. ## Typische Fehler | Symptom | Ursache | Lösung | | --- | --- | --- | | Hinweis auf Datenbank-Update bleibt stehen | Hintergrundaufgabe läuft nicht, etwa weil WP-Cron nicht ausgelöst wird | `wp wc update` auf der Kommandozeile ausführen | | Website-Zustand meldet veraltete Template-Überschreibungen | Kopie im Theme hat eine ältere `@version` als das Plugin | Aktuelle Vorlage kopieren, eigene Änderungen neu einarbeiten, oder Theme aktualisieren | | Erweiterung funktioniert nach dem Update nicht mehr | Erweiterung ist mit der neuen WooCommerce-Version nicht kompatibel | Update der Erweiterung einspielen, sonst Backup zurückspielen | | Kritischer Fehler nach dem Update | PHP-Fehler in einer Erweiterung oder im Theme | Wiederherstellungsmodus nutzen, siehe [Wiederherstellungsmodus bei kritischem Fehler](https://s-edv.com/anleitungen/wordpress-kritischer-fehler-wiederherstellungsmodus-nutzen) | | Datenbank-Stand nach Rückkehr zur alten Version höher als Plugin | Nur die Plugin-Dateien wurden zurückgesetzt, die Datenbank nicht | Vollständig aus dem Backup von Schritt 3 zurückspielen | ## Häufige Fragen ### Kann ich WooCommerce auf eine ältere Version zurücksetzen? Die Plugin-Dateien lassen sich mit `wp plugin install woocommerce --version=VERSION --force` auf eine ältere Version bringen. Hat das Datenbank-Update schon stattgefunden, passt die Datenbank aber nicht mehr zu den alten Dateien. Sauber ist nur das Zurückspielen des vollständigen Backups. Bestellungen, die seitdem eingegangen sind, müssen Sie dann gesondert sichern. Details zu Rollbacks finden Sie in der Anleitung [Plugin-Update rückgängig machen](https://s-edv.com/anleitungen/wordpress-plugin-update-rollback-vorherige-version). ### Sollte ich automatische Updates für WooCommerce einschalten? Für einen Shop mit Umsatz eher nicht. Ein automatisches Update kann nachts ein Datenbank-Update auslösen, ohne dass jemand danach den Checkout prüft. Kleinere Sicherheitsupdates spielen Sie dennoch zeitnah ein, nur eben bewusst. ### Wie lange dauert das Datenbank-Update? Bei kleinen Shops Sekunden. Bei vielen Bestellungen und Produkten kann es deutlich länger laufen. Probieren Sie es deshalb auf einer Staging-Kopie mit echtem Datenbestand aus, dann kennen Sie die Dauer vorher. ### Brauche ich den Systemstatus, wenn der Website-Zustand nichts meldet? Der Systemstatus zeigt mehr Details, etwa alle Überschreibungen mit Versionen, auch die aktuellen. Er ist außerdem der Bericht, den Support-Teams von Erweiterungen meist anfordern. ## Fazit WooCommerce-Updates bleiben beherrschbar, wenn Sie immer denselben Ablauf gehen: Stand erfassen, Kompatibilität prüfen, sichern, Plugin aktualisieren, Datenbank-Update ausführen, Vorlagen kontrollieren und eine Testbestellung durchspielen. Wer diese Routine für seinen Shop lieber abgibt, findet sie in der [WordPress-Wartung](https://wordpressupdate.de/?utm_source=s-edv.com&utm_medium=fazit&utm_campaign=124) von Marcel Schönfelder. ## Weiterführende Anleitungen und Quellen - [Staging-Umgebung mit WP-CLI einrichten](https://s-edv.com/anleitungen/wordpress-staging-umgebung-wp-cli-einrichten) - [Plugin-Update rückgängig machen](https://s-edv.com/anleitungen/wordpress-plugin-update-rollback-vorherige-version) - [WordPress-Updates prüfen und das Risiko einschätzen](https://s-edv.com/anleitungen/wordpress-updates-pruefen-changelog-risiko-einschaetzen) - [WooCommerce auf wordpress.org](https://wordpress.org/plugins/woocommerce/) - [WooCommerce 11.2.0: Release notes](https://developer.woocommerce.com/2026/10/07/woocommerce-11-2-0-release-notes/) - [WooCommerce-Doku: Fixing outdated WooCommerce templates](https://developer.woocommerce.com/docs/theming/theme-development/fixing-outdated-woocommerce-templates/) - [WP-CLI: wp plugin update](https://developer.wordpress.org/cli/commands/plugin/update/)