Shopify-Theme nach Update kaputt: Ursache finden, ohne den Shop zu gefährden

Ein Theme-Update in Shopify verspricht neue Funktionen und Fehlerbehebungen. Nach der Veröffentlichung sieht der Shop dann anders aus als erwartet: Ein Banner ist verschwunden, die Produktseite zeigt kein Größenraster mehr, ein Rabatt-Hinweis fehlt, oder ein App-Widget erscheint an der falschen Stelle. Die Bestellungen laufen weiter, aber etwas stimmt nicht, und jeder Besucher sieht es.

Die wichtigste Regel vorweg: Reparieren Sie nicht im veröffentlichten Theme. Shopify gibt Ihnen alle Werkzeuge, um das Problem in einer Kopie zu lösen.

Wie ein Theme-Update in Shopify funktioniert

Bei Themes aus dem Shopify Theme Store wird beim Update nicht das bestehende Theme überschrieben. Shopify legt eine neue Version als Entwurf in Ihrer Theme-Bibliothek an, mit dem Namenszusatz „Updated copy of“. Ihr bisheriges Theme bleibt erhalten, bis Sie es selbst löschen.

Beim Übertragen unterscheidet Shopify zwei Arten von Anpassungen:

• Einstellungen aus dem Theme-Editor – Farben, Schriften, Sektionen, Blöcke, eigene Templates, App-Embeds – werden in die neue Version übernommen.
• Änderungen am Code – also alles, was jemand im Code-Editor in Liquid-, CSS- oder JavaScript-Dateien geändert hat – werden nur übernommen, wenn sie nicht mit dem Update kollidieren. Kollidieren sie, fehlen sie in der neuen Version. Shopify weist beim Update darauf hin.

Daraus ergibt sich die häufigste Ursache für „kaputt nach Update“: Eine frühere Code-Anpassung, etwa von einer Agentur oder einem Freelancer, ist in der neuen Version nicht mehr enthalten. Niemand hat den Hinweis bemerkt, und die neue Version wurde veröffentlicht.

Erste Hilfe: die alte Version zurückholen

Wenn der Fehler Umsatz kostet, stellen Sie zuerst den vorherigen Zustand wieder her und suchen danach in Ruhe:

1. Im Shopify-Admin unter Onlineshop → Themes die Theme-Bibliothek öffnen.
2. Das vorherige Theme suchen. Es liegt noch dort, sofern es nicht gelöscht wurde.
3. Über das Aktionsmenü eine Vorschau öffnen und prüfen, ob dort alles funktioniert.
4. Das vorherige Theme veröffentlichen.

Die Inhalte Ihres Shops – Produkte, Kollektionen, Seiten, Bestellungen – hängen nicht am Theme und sind davon nicht betroffen. Allerdings: Einstellungen, die Sie seit dem Update im neuen Theme vorgenommen haben, fehlen im alten. Notieren Sie diese vorher.

Ist das alte Theme bereits gelöscht, bleibt der Weg über die Dateiversionen: Im Code-Editor können Sie für einzelne Dateien ältere Versionen aufrufen und wiederherstellen. Das ist mühsamer, aber für einzelne Dateien oft ausreichend.

Die Ursache finden

Schritt 1: Was hat sich geändert?

Halten Sie fest, was genau nicht funktioniert, auf welchen Seiten und auf welchen Geräten. „Die Produktseite ist kaputt“ hilft wenig. „Auf der Produktseite fehlt unter dem Preis der Hinweis zur Lieferzeit, auf Mobil und Desktop“ grenzt die Suche auf eine Sektion ein.

Schritt 2: Alte und neue Version vergleichen

Am zuverlässigsten ist ein Vergleich der Dateien. Mit der Shopify CLI laden Sie beide Themes lokal herunter:

shopify theme list --store ihr-shop.myshopify.com
shopify theme pull --theme 123456789 --path alt
shopify theme pull --theme 987654321 --path neu
diff -r alt/sections neu/sections

Statt diff eignet sich auch ein Git-Repository: alte Version committen, neue Version darüberkopieren, Änderungen im Diff-Werkzeug ansehen. So sehen Sie auf einen Blick, welche eigenen Änderungen fehlen und welche Dateien das Update neu strukturiert hat.

Gesucht sind vor allem Stellen, die nicht vom Theme-Hersteller stammen: eigene Snippets, zusätzliche Liquid-Bedingungen, eingefügte Skripte, CSS-Regeln am Ende einer Datei.

Schritt 3: Apps prüfen

Viele Apps arbeiten heute über App-Blöcke und App-Embeds, die im Theme-Editor aktiviert werden und ein Update überstehen. Ältere Apps haben dagegen Code direkt in Theme-Dateien geschrieben, etwa in theme.liquid oder in ein Produkt-Template. Dieser Code ist nach einem Update möglicherweise nicht mehr vorhanden.

Prüfen Sie im Theme-Editor unter App-Embeds, ob alle benötigten Embeds aktiv sind. Prüfen Sie bei älteren Apps in deren Dokumentation, welchen Code sie ins Theme schreiben, und ob es inzwischen eine Variante mit App-Blöcken gibt.

Schritt 4: Browser-Konsole

Öffnen Sie die Vorschau der neuen Version mit den Entwicklertools des Browsers. JavaScript-Fehler in der Konsole zeigen oft direkt, dass ein Skript ein Element sucht, das es im neuen Theme nicht mehr gibt, zum Beispiel weil eine CSS-Klasse umbenannt wurde.

Sonderfall: Theme nicht aus dem Theme Store

Nicht jedes Theme stammt aus dem offiziellen Theme Store. Themes von Drittanbietern oder individuell entwickelte Themes werden nicht über die Update-Funktion von Shopify aktualisiert. Ein „Update“ bedeutet hier meist, dass jemand eine neue Version als ZIP hochgeladen oder Dateien manuell ersetzt hat.

Für diesen Fall gilt:

• Eine automatische Übernahme von Einstellungen gibt es nicht. Prüfen Sie, ob die Theme-Einstellungen der neuen Version zu den alten passen. Die Einstellungen stehen in config/settings_data.json, die Inhalte der Templates in den JSON-Dateien unter templates/.
• Wurde die neue Version als zusätzliches Theme hochgeladen, liegt die alte noch in der Bibliothek. Wurde direkt im veröffentlichten Theme gearbeitet, helfen nur die Dateiversionen im Code-Editor oder ein Backup.
• Fragen Sie beim Anbieter des Themes nach dem Änderungsprotokoll. Es nennt oft umbenannte Sektionen oder Einstellungen, die den Fehler erklären.

In einer Kopie reparieren

Die Reparatur selbst gehört in eine Kopie des Themes, nicht in das veröffentlichte:

1. Die neue Theme-Version in der Bibliothek duplizieren.
2. Die fehlenden Anpassungen in der Kopie nachziehen, angepasst an die neue Struktur. Einfaches Zurückkopieren alter Dateien überschreibt häufig die Verbesserungen des Updates.
3. Wo möglich, Anpassungen als eigene Sektion, eigenes Snippet oder über Theme-Einstellungen umsetzen, statt Hersteller-Dateien zu verändern. Das macht das nächste Update leichter.
4. Über den Vorschau-Link testen: Startseite, Kollektion, Produkt mit und ohne Varianten, Warenkorb, Checkout-Einstieg, Mobil und Desktop.
5. Erst dann veröffentlichen.

Für die Arbeit an Shopify-Themes mit mehreren Beteiligten lohnt sich die GitHub-Integration von Shopify. Das Theme liegt dann in einem Repository, und jede Änderung ist nachvollziehbar.

Beim nächsten Update

• Vor dem Update notieren, welche Code-Anpassungen das Theme enthält. Am besten liegt das Theme ohnehin in Git.
• Den Hinweis von Shopify beim Update ernst nehmen, ob Code-Änderungen übernommen wurden.
• Die neue Version als Entwurf vollständig über die Vorschau prüfen, bevor sie veröffentlicht wird.
• Das vorherige Theme einige Wochen in der Bibliothek behalten.
• Neue Anpassungen so bauen, dass sie Updates überstehen: eigene Sektionen und Snippets, App-Blöcke statt eingefügtem Code.

Checkliste für den Ernstfall

• Fehler genau beschrieben: Seite, Element, Gerät
• Vorheriges Theme in der Bibliothek gefunden und per Vorschau geprüft
• Bei Umsatzrelevanz: vorheriges Theme wieder veröffentlicht
• Alte und neue Version verglichen, fehlende Anpassungen identifiziert
• App-Embeds und App-Code geprüft
• Reparatur in einer Kopie, Test über den Vorschau-Link
• Erst nach dem Test veröffentlicht

Häufige Fragen

Gehen beim Zurückwechseln auf das alte Theme Produkte oder Bestellungen verloren?

Nein. Produkte, Kollektionen, Seiten und Bestellungen hängen nicht am Theme. Es fehlen nur Einstellungen, die Sie seit dem Update im neuen Theme vorgenommen haben; notieren Sie diese vor dem Wechsel.

Warum fehlen nach dem Shopify-Update meine Code-Anpassungen?

Shopify übernimmt Einstellungen aus dem Theme-Editor in die neue Version, Änderungen am Code aber nur, wenn sie nicht mit dem Update kollidieren. Kollidieren sie, fehlen sie in der neuen Version; Shopify weist beim Update darauf hin. Häufig betrifft das frühere Anpassungen einer Agentur oder eines Freelancers.

Wie vermeide ich Probleme beim nächsten Theme-Update?

Halten Sie fest, welche Code-Anpassungen das Theme enthält, am besten mit dem Theme in Git. Prüfen Sie die neue Version als Entwurf vollständig über die Vorschau, bevor Sie sie veröffentlichen, und behalten Sie das alte Theme einige Wochen in der Bibliothek. Neue Anpassungen bauen Sie möglichst als eigene Sektionen, Snippets oder App-Blöcke.

---

Wenn wir an einem Shopify-Theme arbeiten, schicken wir eine Mitarbeiter-Zugriffsanfrage an Ihren Shop, die Sie bestätigen. Passwörter brauchen wir nicht. Gearbeitet wird in einer Kopie Ihres Themes; Sie erhalten einen Vorschau-Link, prüfen und veröffentlichen selbst. Im Prozess-Abo legen Sie das Problem als Karte auf Ihr Board: was fehlt, auf welchen Seiten, auf welchen Geräten. 48 Stunden nach Start (gezählt Mo 8 – Fr 16 Uhr) liegt die Theme-Kopie mit den wiederhergestellten Anpassungen bereit. Ein Senior-Entwickler hat sie vorher geprüft und freigegeben. Sind beim Update viele Anpassungen verloren gegangen, teilen wir die Arbeit in mehrere Karten auf. Die erste Aufgabe erledigen wir kostenlos, eine pro Unternehmen. Mehr dazu unter Fehler beheben und im Leistungskatalog.