Shopify-Theme nach Update defekt? Die nächsten Schritte

Sie haben Ihr Shopify-Theme aktualisiert, oder jemand hat es für Sie getan, und jetzt sieht etwas anders aus oder funktioniert anders. Vielleicht ist ein Abschnitt verschwunden, das Layout stimmt nicht, eine individuelle Funktion fehlt oder der Warenkorb verhält sich nicht mehr wie zuvor.

Typische Symptome sind:

individuelle Abschnitte oder Blöcke fehlen
Farben, Schriften oder Abstände haben sich verändert
eine Funktion, die ein Entwickler hinzugefügt hat, funktioniert nicht mehr
ein App-Widget, etwa Bewertungen oder eine Größentabelle, ist verschwunden
der Warenkorb oder der Button „In den Warenkorb“ verhält sich anders
Seiten sehen auf dem Desktop gut aus, auf dem Smartphone aber nicht

Die gute Nachricht: In Shopify zerstört ein Theme-Update Ihr altes Theme normalerweise nicht. In den meisten Fällen befindet sich die vorherige Version noch in Ihrer Theme-Bibliothek, und Sie können zu ihr zurückkehren, während Sie herausfinden, was sich geändert hat.

Dieser Leitfaden erklärt, wie Theme-Updates grundsätzlich funktionieren, warum Anpassungen womöglich nicht übernommen werden, wie Sie die vorherige Version sicher wiederherstellen und wie Sie dasselbe Problem beim nächsten Mal vermeiden.

Wie funktionieren Shopify-Theme-Updates?

Ein Shopify-Theme besteht aus Vorlagen, Abschnitten, Einstellungen und Code, die bestimmen, wie Ihr Shop aussieht und sich verhält.

Wenn es für ein Theme aus dem Shopify Theme Store eine neue Version gibt, lässt Shopify Sie die aktualisierte Version in der Regel Ihrer Theme-Bibliothek hinzufügen, statt das genutzte Theme zu überschreiben. Die genauen Schritte können je nach Theme und je nachdem, wie Shopify Updates gerade darstellt, variieren, aber das Grundprinzip ist:

das Update kommt als neue Kopie des Themes
im Theme-Editor vorgenommene Einstellungen werden, soweit möglich, in der Regel übernommen
direkt im Theme-Code vorgenommene Änderungen werden in der Regel nicht übernommen
Ihr aktuelles Theme bleibt in der Bibliothek, bis Sie es entfernen

Deshalb kann ein Update defekt aussehen, obwohl nichts „verloren“ gegangen ist: Die neue Version enthält einfach nicht den individuellen Code, der der alten hinzugefügt wurde.

Themes aus anderen Quellen oder individuelle Themes, die ein Entwickler gebaut hat, werden möglicherweise gar nicht auf diese Weise aktualisiert. Sie müssen eventuell manuell, Datei für Datei, aktualisiert werden.

Warum funktioniert mein Theme nach dem Update nicht mehr?

Individueller Code wurde nicht übernommen

Wenn ein Entwickler, eine Agentur oder eine App die Theme-Dateien bearbeitet hat, existieren diese Änderungen nur in der alten Version. Typische Beispiele:

individuelle Abschnitte oder Snippets
Änderungen an der Produktseite oder am Warenkorb
Tracking- oder Analytics-Code
kleine Korrekturen am Styling
Code, den eine App bei der Installation hinzugefügt hat

Die neue Version beginnt mit dem Originalcode des Theme-Entwicklers, daher fehlen diese Änderungen.

Abschnitte und Einstellungen haben sich in der neuen Version geändert

Theme-Entwickler benennen Abschnitte und Einstellungen zwischen Versionen manchmal um, führen sie zusammen oder entfernen sie. Eine Einstellung, auf die Sie sich verlassen haben, funktioniert jetzt vielleicht anders oder existiert nicht mehr. Inhalte, die an einen entfernten Abschnitt gebunden waren, werden womöglich nicht angezeigt.

App-Einbettungen und App-Blöcke müssen erneut aktiviert werden

Viele Apps fügen Funktionen über App-Einbettungen oder App-Blöcke im Theme-Editor hinzu. In einer neuen Theme-Version müssen einige davon eventuell erneut aktiviert oder wieder im richtigen Abschnitt platziert werden.

Ältere Apps, die Code direkt in die Theme-Dateien eingefügt haben, erscheinen in der neuen Version möglicherweise gar nicht, weil dieser Code Teil des alten Themes war.

Das Update wurde sofort veröffentlicht

Wenn das aktualisierte Theme veröffentlicht wurde, bevor jemand es geprüft hat, sehen Kunden die Probleme sofort. Das ist der häufigste Grund, warum aus einem Routine-Update ein dringender Fall wird.

Finden Sie zuerst heraus, was sich geändert hat

Bevor Sie etwas anderes ändern, beantworten Sie diese Fragen:

Wann wurde das Theme aktualisiert, und von wem?
Wurde die neue Version veröffentlicht, oder ist sie noch unveröffentlicht?
Ist die vorherige Version noch in Ihrer Theme-Bibliothek?
Was genau funktioniert nicht: eine Seite, ein Abschnitt, eine Funktion, der Warenkorb?
Tritt das Problem auf dem Desktop, auf dem Smartphone oder auf beiden auf?
Wurde das alte Theme mit Code angepasst, von einem Entwickler oder durch Apps?

Wenn jemand anderes das Update durchgeführt hat, fragen Sie, welche Version installiert wurde und ob bekannt war, dass das alte Theme individuellen Code enthält.

Was können Sie gefahrlos ausprobieren?

Öffnen Sie Ihre Theme-Bibliothek

Gehen Sie zu Online Store → Themes (Onlineshop → Themes). Dort sehen Sie Ihr aktuelles (veröffentlichtes) Theme und eine Bibliothek weiterer Themes. Suchen Sie die vorherige Version: Sie hat oft denselben Namen mit einer anderen Versionsnummer oder einem anderen Datum.

Sehen Sie sich die vorherige Version in der Vorschau an

Sehen Sie sich die alte Version in der Vorschau an, bevor Sie etwas unternehmen. Die Vorschau ändert nicht, was Kunden sehen. Prüfen Sie, ob sie noch wie erwartet aussieht und funktioniert, einschließlich des Warenkorbs.

Veröffentlichen Sie bei Bedarf die vorherige Version

Wenn der Shop eindeutig defekt ist und die alte Version funktioniert, ist das Veröffentlichen der alten Version meist der schnellste Weg, den Shop für Kunden wiederherzustellen. Anschließend können Sie in Ruhe an der unveröffentlichten neuen Version arbeiten.

Denken Sie vor dem Veröffentlichen an alles, was Sie seit dem Update in der neuen Version geändert haben, etwa neue Inhalte in Abschnitten oder neue Einstellungen. Diese Änderungen existieren in der alten Version möglicherweise nicht. Notieren Sie sie, damit sie später erneut übernommen werden können.

Prüfen Sie App-Einbettungen und Blöcke

Öffnen Sie den Theme-Editor für das Theme, in dem eine App-Funktion fehlt, und prüfen Sie den Bereich der App-Einbettungen. Ist die Einbettung einer App deaktiviert, kann das Aktivieren die Funktion zurückbringen. Manche Apps müssen ihren Block außerdem erneut in einem bestimmten Abschnitt platzieren.

Behalten Sie beide Versionen

Löschen Sie die alte Version nicht. Sie enthält den individuellen Code, der in die neue Version übernommen werden muss. Behalten Sie sie in der Bibliothek, bis die neue Version vollständig und getestet ist.

Was sollten Sie vermeiden?

Vermeiden Sie:

das alte Theme aus der Bibliothek zu löschen
den Code des Live-Themes ohne Duplikat zu bearbeiten
ein weiteres Update auf ein defektes zu installieren
Apps zum „Aufräumen“ zu deinstallieren, bevor Sie wissen, was sie tun
Dateien aus dem alten Theme in das neue zu kopieren, ohne sie zu verstehen
anzunehmen, dass sich die alte Version später von selbst erneut aktualisiert

Ändern Sie immer nur eine Sache auf einmal und prüfen Sie jede Änderung in der Vorschau, bevor Sie veröffentlichen.

Wie können Sie das beim nächsten Mal vermeiden?

Ein Theme-Update sollte wie jede andere Änderung an einem Live-Shop behandelt werden:

Zuerst duplizieren. Erstellen Sie vor dem Bearbeiten von Code oder einem Update ein Duplikat des Live-Themes. Das kostet nichts und gibt Ihnen eine saubere Rückfallebene.
Individuellen Code dokumentieren. Eine kurze Liste, was wo und warum geändert wurde, macht Updates deutlich einfacher.
In der Bibliothek aktualisieren, nicht live. Fügen Sie die neue Version hinzu, lassen Sie sie unveröffentlicht und prüfen Sie sie sorgfältig.
Anpassungen in die neue Version übernehmen, bevor Sie sie veröffentlichen.
Die wichtigen Abläufe testen: Startseite, Kollektion, Produktseite, Warenkorb, Beginn des Checkouts, mobile Ansicht.
Zu einer ruhigen Zeit veröffentlichen und die alte Version eine Weile behalten, falls Sie sie brauchen.

Wann sollten Sie technische Unterstützung anfragen?

Es ist sinnvoll, Hilfe zu holen, wenn:

das alte Theme individuellen Code enthält und Sie nicht wissen, was er tut
der Warenkorb, der Beginn des Checkouts oder Produktoptionen betroffen sind
Apps, die früher funktioniert haben, nicht mehr erscheinen
die vorherige Version in der Bibliothek fehlt
Sie die Funktionen der neuen Version, aber auch Ihre alten Anpassungen brauchen
das Theme individuell gebaut ist oder nicht aus dem Theme Store stammt
Sie bereits einige Änderungen ausprobiert haben und nicht sicher sind, in welchem Zustand das Theme ist

Sie müssen nicht genau wissen, was kaputtgegangen ist, bevor Sie um Hilfe bitten.

Welche Informationen sollten Sie sammeln?

Nützliche Angaben sind:

die URL Ihres Shops
der Name des Themes sowie die alte und die neue Versionsnummer
wann das Update durchgeführt wurde und von wem
ob die neue Version veröffentlicht ist
was nicht funktioniert, mit Screenshots
eine Liste bekannter Anpassungen und der Apps, die mit dem Theme interagieren

Wenn jemand an Ihrem Theme arbeiten muss, fügen Sie die Person im Shopify-Admin als Mitarbeiter oder als Collaborator hinzu. Senden Sie Ihr Admin-Passwort nicht per E-Mail.

Wie D4Hub helfen kann

D4Hub unterstützt Sie bei:

der Identifizierung der vorherigen funktionierenden Version und ihrer sicheren Wiederherstellung
dem Vergleich der alten und neuen Theme-Version, um den individuellen Code zu finden
der Übernahme der Anpassungen in die neue Version
der erneuten Aktivierung und Platzierung von App-Einbettungen und Blöcken
Tests der Produktseite, des Warenkorbs und des Checkout-Beginns in der neuen Version
der Dokumentation Ihrer Anpassungen, damit künftige Updates einfacher werden
der Einrichtung eines sichereren Ablaufs für Theme-Updates

Sie können in jeder Phase Unterstützung anfragen, ob Sie nur Hilfe beim Finden der richtigen Version brauchen oder das gesamte Update übernehmen lassen möchten.

Support-Ticket eröffnen

Für technisch versierte Nutzer: Theme-Versionen vergleichen und wiederherstellen

Diese Schritte richten sich an Nutzer, die mit dem Shopify-Theme-Editor und dem Code-Editor vertraut sind. Arbeiten Sie immer an einem Duplikat, niemals am Live-Theme, und behalten Sie die alte Version, bis die neue vollständig getestet ist.

Vor allem anderen duplizieren

Verwenden Sie unter Online Store → Themes (Onlineshop → Themes) das Aktionsmenü Ihres Live-Themes, um es zu duplizieren. Machen Sie dasselbe mit jeder Version, die Sie bearbeiten möchten. Ein Duplikat ist Ihr Sicherheitsnetz.

Sie können über das Aktionsmenü des Themes auch eine Kopie der Theme-Dateien herunterladen. Shopify sendet die Datei per E-Mail an das Konto, sodass Sie eine Offline-Kopie haben.

Den individuellen Code in der alten Version finden

Öffnen Sie den Code-Editor für die alte Version (im Aktionsmenü des Themes die Option zum Bearbeiten des Codes wählen). Suchen Sie nach:

Dateien, die in der neuen Version nicht existieren, oft in den Ordnern für Abschnitte und Snippets
Dateien, deren Name auf eine App oder eine individuelle Funktion verweist
kürzlichen Änderungen: Im Code-Editor können Sie ältere Versionen einer Datei ansehen, was hilft, Bearbeitungen zu erkennen

Erstellen Sie eine Liste der gefundenen Dateien und Änderungen, bevor Sie etwas verschieben.

Dateien zwischen den Versionen vergleichen

Für einen zuverlässigeren Vergleich laden Sie beide Versionen herunter und vergleichen die Dateien auf Ihrem Computer mit einem Tool zum Dateivergleich. Entwickler, die Shopify CLI nutzen, können jedes Theme lokal abrufen, um sie zu vergleichen. Unterschiede in Dateien, von denen Sie wissen, dass sie angepasst wurden, sind diejenigen, die übernommen werden müssen.

Kopieren Sie keine ganzen Dateien aus der alten Version in die neue. Eine Datei kann auch Änderungen des Theme-Entwicklers enthalten, von denen die neue Version abhängt. Kopieren Sie nur die individuellen Teile und prüfen Sie nach jeder Änderung die Vorschau.

App-Einbettungen und Blöcke prüfen

Öffnen Sie in der neuen Version den Theme-Editor und:

Prüfen Sie den Bereich der App-Einbettungen und aktivieren Sie die Einbettungen, die Ihre Apps brauchen.
Prüfen Sie die Abschnitte, in denen früher App-Blöcke erschienen, und fügen Sie sie bei Bedarf erneut hinzu.
Sehen Sie sich die Produktseite, den Warenkorb und jede Seite, auf der Apps Inhalte anzeigen, in der Vorschau an.

Vor dem Veröffentlichen testen

Sehen Sie sich die neue Version in der Vorschau an und testen Sie:

Startseite, eine Kollektionsseite und eine Produktseite
Produktoptionen und Varianten
das Hinzufügen zum Warenkorb, die Warenkorbseite oder das Warenkorb-Fenster und den Beginn des Checkouts
Smartphone und Desktop
jede Funktion, die auf individuellem Code oder Apps beruhte

Veröffentlichen Sie erst, wenn all das funktioniert. Behalten Sie die alte Version danach noch einige Zeit in der Bibliothek.

Häufig gestellte Fragen

Hat das Update mein altes Theme gelöscht?

In der Regel nicht. Bei Themes aus dem Shopify Theme Store wird das Update normalerweise als separate Version in Ihre Theme-Bibliothek eingefügt, und die alte Version bleibt dort, sofern sie niemand entfernt.

Warum fehlen meine Anpassungen?

Direkt im Theme-Code vorgenommene Änderungen werden in der Regel nicht in eine neue Theme-Version übernommen. Einstellungen aus dem Theme-Editor werden meist übernommen, soweit die neue Version sie unterstützt.

Kann ich einfach zur alten Version zurückkehren?

In den meisten Fällen ja. Sehen Sie sich die vorherige Version in der Vorschau an, prüfen Sie, ob sie funktioniert, und veröffentlichen Sie sie. Notieren Sie vorher alle Änderungen, die Sie in der neuen Version vorgenommen haben, denn sie existieren in der alten womöglich nicht.

Muss ich mein Theme überhaupt aktualisieren?

Updates können Fehlerbehebungen, neue Funktionen und Kompatibilität mit Änderungen bei Shopify bringen, daher lohnt es sich, Themes einigermaßen aktuell zu halten. Am sichersten ist es, in der Bibliothek zu aktualisieren, Anpassungen erneut zu übernehmen und vor dem Veröffentlichen zu testen.

Wahrscheinlich nicht. Prüfen Sie im Theme-Editor der neuen Version die App-Einbettungen und App-Blöcke. Manche Apps müssen nach einem Theme-Wechsel erneut aktiviert oder platziert werden.

Kann D4Hub mein Theme aktualisieren, ohne dass Anpassungen verloren gehen?

D4Hub kann die Versionen vergleichen, Ihren individuellen Code übernehmen und die neue Version testen, bevor sie live geht. Ziel ist, dass Kunden das aktualisierte Theme erst sehen, wenn es wie erwartet funktioniert.

Mein Shopify-Theme funktioniert nach einem Update nicht mehr: Was tun?