Shopify Theme-Update: Anpassungen weg? So lösen Sie es sauber

Der Moment ist immer derselbe: Ein Klick auf „Veröffentlichen" nach dem Shopify Theme-Update — und plötzlich fehlt etwas. Der Ankündigungsbalken ist weg, das Cookie-Banner erscheint nicht mehr, der mühsam eingebaute Grundpreis-Block auf der Produktseite ist verschwunden. Wer das einmal live im Shop erlebt hat, aktualisiert sein Theme danach oft jahrelang gar nicht mehr — und tauscht ein lösbares Prozessproblem gegen veralteten Code, Sicherheitslücken und fehlende Features.

Dabei ist das Verhalten kein Bug, sondern Systemlogik: Ein Shopify Theme-Update ist technisch keine Aktualisierung Ihres Themes, sondern eine neue Theme-Kopie. Alles, was an die alte Kopie gebunden war — Theme-Settings, Code-Änderungen, aktivierte App-Embeds — ist im neuen Stand nur dann vorhanden, wenn es sauber mitgenommen wurde. In diesem Artikel erkläre ich den Mechanismus dahinter, zeige meine eigene Praxis-Regel aus einem Vorfall, der mir genau einmal passiert ist, und führe durch einen Update-Workflow, mit dem nichts mehr verloren geht.

Warum ein Shopify Theme-Update Anpassungen überschreibt

Anpassungen werden in Shopify auf zwei grundsätzlich verschiedenen Ebenen gespeichert:

Shop-Ebene: Produkte, Collections, Navigation, Metafelder samt Definitionen, Seiten, Blog-Inhalte. Diese Daten gehören dem Shop und sind vom Theme unabhängig — sie überleben jeden Theme-Wechsel.

Theme-Ebene: Farben, Schriften und alle Einstellungen aus dem Customizer (gespeichert in der settings_data.json der jeweiligen Theme-Kopie), die Section-Anordnung pro Seite (JSON-Templates), jede Code-Änderung an Liquid-, CSS- oder JavaScript-Dateien — und, oft übersehen, die Aktivierung von App-Embeds. All das existiert pro Theme-Kopie. Eine andere Kopie desselben Themes weiß davon nichts.

Der offizielle Updater: neue Kopie statt Aktualisierung

Wenn Shopify für ein Theme aus dem Theme Store ein Update anbietet, läuft laut Shopify-Doku zum Theme-Update Folgendes ab: Das Update wird als neue Entwurfs-Kopie mit dem Namenspräfix „Updated copy of" angelegt — das Live-Theme bleibt unangetastet. Customizer-Anpassungen nimmt der Updater automatisch mit: Theme-Settings, Section- und Block-Änderungen, neu angelegte Templates und auch die Einstellungen von App-Embeds und App-Erweiterungen.

Der kritische Teil sind Code-Änderungen. Die übernimmt der Updater nur, wenn sie nicht mit dem Update kollidieren. Im Konfliktfall meldet Shopify „code edits could not be included" — und genau dann müssen die betroffenen Anpassungen von Hand in den neuen Stand übertragen werden. Wer diese Meldung überliest und die Update-Kopie direkt veröffentlicht, hat den klassischen Panik-Moment: Das selbst eingebaute Snippet ist im neuen Theme schlicht nicht vorhanden.

Der unterschätzte Fall: App-Embeds sind Theme-Zustand

Noch häufiger als der Update-Konflikt ist in meiner Praxis ein anderes Muster: Es wird gar nicht der offizielle Updater benutzt, sondern eine ältere Theme-Kopie veröffentlicht — ein Redesign-Entwurf, ein vor Monaten angelegtes Duplikat, ein frisch installiertes Theme. App-Embeds (Cookie-Banner, Tracking-Snippets, Chat-Widgets, GPSR- oder Bewertungs-Widgets) werden von Apps aber im Regelfall im Live-Theme aktiviert und konfiguriert. Die Aktivierung landet in der settings_data.json genau dieser einen Kopie.

Die Folge: Die Entwurfs-Kopie, die vor der App-Einrichtung entstanden ist, hat diese Embeds nie gesehen. Beim Publish wirkt es, als hätte der Wechsel die Apps „gelöscht" — tatsächlich waren sie in der neuen Kopie nie aktiviert. Die Apps selbst laufen weiter, nur ihre Storefront-Ausgabe fehlt.

Die gute Nachricht in beiden Fällen: Verloren ist fast nie etwas. Das bisherige Live-Theme bleibt nach dem Wechsel in der Theme-Bibliothek erhalten und lässt sich jederzeit wieder veröffentlichen oder als Referenz nutzen. Wie viele Themes die Bibliothek fasst, hängt laut Shopify-Doku vom Plan ab:

Meine Praxis-Regel: Vor jedem Publish gegen das Live-Theme diffen

Technisch ist der Diff mit der Shopify CLI unspektakulär: beide Theme-Stände in getrennte Ordner ziehen und mit Git vergleichen — ein Repository ist dafür nicht nötig.

# Theme-IDs anzeigen (Live-Theme ist mit [live] markiert)
shopify theme list --store=mein-shop.myshopify.com
 
# Beide Stände in getrennte Ordner ziehen
shopify theme pull --theme=LIVE_THEME_ID --path=theme-live
shopify theme pull --theme=DRAFT_THEME_ID --path=theme-draft
 
# Vergleich ohne Git-Repository
git diff --no-index theme-live theme-draft

Drei Stellen verdienen im Diff besondere Aufmerksamkeit: config/settings_data.json (Theme-Settings und App-Embed-Aktivierungen), die JSON-Templates unter templates/ (Section-Anordnung, App-Blocks pro Seite) und alle Dateien unter snippets/ und sections/, die nicht zum Original-Theme gehören — das sind Ihre Eigenbauten.

Der saubere Update-Workflow in sechs Schritten

So läuft ein Theme-Update bei mir in Kundenprojekten ab — jeder Schritt existiert, weil sein Weglassen irgendwann Geld gekostet hätte:

1. Anpassungs-Inventar erstellen

   Bevor irgendetwas aktualisiert wird: Welche Anpassungen hat das Live-Theme überhaupt? Eigene Snippets und Sections, geänderte Original-Dateien, aktivierte App-Embeds, App-Blocks in den Templates. Wer das Theme per CLI oder GitHub-Anbindung versioniert, hat dieses Inventar als Commit-Historie geschenkt.

2. Live-Theme sichern

   Im Admin unter Onlineshop → Themes das Live-Theme duplizieren und zusätzlich per CLI oder als ZIP herunterladen. Das Duplikat in der Bibliothek ist die schnelle Rollback-Option, der lokale Download die Versicherung gegen alles andere.

3. Update als Entwurf ziehen — und die Meldung lesen

   Über die Update-Benachrichtigung im Theme-Bereich die neue Version als Entwurf hinzufügen — und die Erfolgsmeldung tatsächlich lesen. Meldet Shopify, dass Code-Änderungen nicht übernommen werden konnten, müssen die betroffenen Anpassungen manuell aus dem alten Theme-Code in den neuen Stand kopiert werden.

4. Diff gegen das Live-Theme

   Der Kern des Workflows (Befehle siehe oben): Entwurfs-Kopie gegen Live-Theme diffen. Jede Differenz ist entweder erwartet (das Update selbst) oder ein Fund — eine fehlende Eigenbau-Datei, ein verschwundener App-Embed-Eintrag, ein zurückgesetztes Setting. Erst wenn jede Abweichung erklärt ist, geht es weiter.

5. Entwurf im Preview testen

   Die Entwurfs-Vorschau öffnen und die kritischen Seiten durchklicken — nicht nur die Startseite, sondern gezielt: Produktseite (Preise, Grundpreis-Anzeige, Pflichtangaben-Blöcke, Varianten), Collection mit Filtern, Warenkorb samt Upsells, Footer mit allen Rechtslinks, Cookie-Banner, Suche. Bei mehrsprachigen Shops mindestens eine zweite Sprachversion.

6. Veröffentlichen und sofort nachkontrollieren

   Publish in eine traffic-arme Zeit legen, danach dieselbe Checkliste im echten Storefront durchgehen — zusätzlich im Customizer prüfen, ob alle App-Embeds aktiv sind, und einen Testkauf bis zur Checkout-Seite führen. Das alte Theme bleibt als Rollback-Option in der Bibliothek, bis der neue Stand einige Tage unauffällig gelaufen ist.

Welche Anpassungen update-fest sind — und welche nicht

Die langfristig wichtigste Konsequenz aus alledem ist eine Architektur-Frage: Wo baue ich Anpassungen ein, damit das nächste Update kein Projekt wird? Die Faustregel: Alles, was auf Shop-Ebene lebt, ist update-fest; alles im Theme wandert bei jedem Update mit um.

Daraus folgt eine klare Präferenz-Reihenfolge für neue Anpassungen:

Je sauberer Anpassungen von den Original-Dateien getrennt sind, desto öfter kann der Updater Code-Änderungen konfliktfrei mitnehmen — und desto kürzer wird der Diff. Wie Theme-Blocks, Sections und Metafelder seit Online Store 2.0 zusammenspielen, habe ich im Sections-Everywhere-Guide im Detail beschrieben.

Der Compliance-Blick: Wenn mit dem Update Pflichtangaben verschwinden

Ein Theme-Update ist nicht nur ein Design-Risiko, sondern auch ein Compliance-Risiko — aus einem einfachen technischen Grund: Viele Pflichtangaben-Anzeigen sind genau die Art von Anpassung, die in der Theme-Kopie lebt. Der per Snippet eingebaute GPSR-Block auf der Produktseite, eine nachgerüstete Grundpreis-Anzeige, das Energielabel-Widget als App-Embed, das Cookie-Banner: Verschwindet so ein Element beim Publish, zeigt der Shop ab diesem Moment weniger an, als er soll — und niemand bekommt eine Fehlermeldung.

Dass fehlende Angaben im Storefront kein theoretisches Thema sind, zeigt die Entwicklung der Abmahnzahlen: Laut Händlerbund-Abmahnstudie 2025 stieg die Zahl der Abmahnungen gegenüber 2023 um rund 50 Prozent (Sekundärquelle: ihp-media). Welche Prüfpunkte auf der technischen Seite dazugehören, habe ich in der technischen Abmahn-Checkliste zusammengestellt.

Genau deshalb endet mein Update-Workflow nicht mit dem Publish, sondern mit der Nachkontrolle — und genau deshalb existiert das Technik-Monitoring als Dauerleistung: Theme- und App-Updates passieren laufend, die Kontrolle danach sollte es auch.

Fazit: Nicht das Update ist das Risiko — der unkontrollierte Publish ist es

Dass nach einem Shopify Theme-Update Anpassungen verschwinden, ist die logische Folge der Speicherung pro Theme-Kopie — und damit kontrollierbar: Inventar, Backup, Update als Entwurf, Diff gegen das Live-Theme, Preview-Test, Publish mit Nachkontrolle. Wer neue Anpassungen von vornherein update-fest baut — Metafelder statt hartkodierter Daten, eigene Dateien statt geänderter Original-Dateien — macht aus dem nächsten Update einen Routinevorgang statt eines Wochenend-Einsatzes.

Wenn Sie das nicht selbst stemmen wollen: Im Rahmen des Technik-Monitorings (ab 250 €/Monat) übernehme ich den monatlichen Check — inklusive gezielter Kontrolle nach Theme- und App-Updates. Und wenn Sie den Verdacht haben, dass bei einem früheren Update bereits etwas verloren gegangen ist: Das technische Compliance-Audit für 490 € stellt den Ist-Zustand Seite für Seite fest, die Behebung übernehme ich auf Wunsch im Fix-Sprint (ab 1.500 €).

Häufige Fragen

Weiterführende Artikel

• Shopify 2.0 und Sections Everywhere – Die Architektur-Grundlage: wie Theme-Blocks, JSON-Templates und Metafelder zusammenspielen — und warum genau das Anpassungen update-fest macht.
• Abmahnung im Onlineshop: die technische Checkliste – Die Prüfpunkte für die Nachkontrolle nach jedem Update: was auf Produktseite, Footer und im Checkout sichtbar sein muss.
• GPSR im Shopify-Shop: Pflichtangaben richtig anzeigen – Ein typisches Beispiel für Anzeigen, die still verschwinden können — und wie sie per Metafeld update-fest werden.