Migration von checkout.liquid zu Checkout Extensions auf Shopify Plus

Die wichtigsten Punkte

• checkout.liquid ist vollständig abgeschaltet. Die Checkout-Schritte Information, Versand und Zahlung haben es am 13. August 2024 hinter sich gelassen, die Danke- und Bestellstatus-Seiten folgten am 28. August 2025, und ab Januar 2026 hat Shopify die Nachzügler automatisch aktualisiert.
• Vier Tools ersetzen die eine Datei: Checkout UI Extensions für die Benutzeroberfläche, Shopify Functions für die Logik, die Branding API für das Styling und Web Pixels für das Tracking.
• Die Migration ist eine Bestandsaufnahme und Zuordnung. Liste auf, was dein checkout.liquid gemacht hat, weise jeden Punkt seinem neuen Tool zu, baue es in einem Checkout-Konfigurationsentwurf nach und veröffentliche es.
• Ein Großteil davon erfordert keine Entwickler. Branding, Layout, App Blocks und Custom Pixels sind Admin-Aufgaben. Custom UI Extensions, Functions und App Pixels sind Entwicklerarbeit.
• Einige Dinge haben keinen 1:1-Ersatz, einschließlich beliebiger DOM-Bearbeitungen und Styling pro Seite. Plane Workarounds, anstatt auf Parität zu warten.

Eine Migration von checkout.liquid zu Extensions im Jahr 2026 ist keine vorausschauende Planung mehr. Alle Fristen sind verstrichen, die Datei ist deaktiviert, und jeder Shopify Plus-Shop, der nicht rechtzeitig umgezogen ist, wurde automatisch geupgradet.

Das ändert den Zweck dieses Guides. Wenn deine Rabattlogik am 30. Juni zusammen mit Shopify Scripts gestorben ist, wenn das Tracking deiner Danke-Seite durch die automatischen Upgrades im Januar verschwunden ist, oder wenn du seit der Umstellung einen nahezu unveränderten Standard-Checkout betreibst und deine Anpassungen vor BFCM zurückhaben möchtest, ist dies dein Playbook für den Neuaufbau.

Unser älterer Leitfaden zur Änderung von checkout.liquid in Shopify Plus dokumentiert das Legacy-System, das dieser Artikel ersetzt. Für die vollständige Übersicht des neuen Frameworks siehe unseren vollständigen Leitfaden zur Shopify Checkout Extensibility – dieser Artikel konzentriert sich auf den praktischen Weg von Alt zu Neu.

Warum du uns vertrauen kannst

Wir sind seit über vier Jahren im Shopify-Bereich tätig und haben mit hunderten von Shopify-Marken an ihren Storefronts gearbeitet, einschließlich Shops, die genau dieses Upgrade durchlaufen haben. Wir bauen Fudge, den AI-Operator für Shopify-Shops, mit einer 4.9-Bewertung im Shopify App Store, daher arbeiten wir täglich in der Theme- und Admin-Ebene, durch die diese Migration läuft.

Wo die Abschaltung von checkout.liquid im Jahr 2026 steht

Jedes Datum in dieser Tabelle liegt in der Vergangenheit. Sie ist hier, damit du herausfinden kannst, welche Teile deines alten Setups wann kaputtgegangen sind, und was du neu baust.

Zwei Details in dieser Tabelle sind für die vor dir liegende Arbeit wichtig.

Dein alter Code ist noch lesbar. Zusätzliche Skripte (additional scripts) wurden schreibgeschützt statt gelöscht², und die Datei checkout.liquid liegt möglicherweise immer noch im Code-Editor deines Themes. Das macht das Audit in Schritt 1 ohne Archäologie möglich.

Das automatische Upgrade hat nichts migriert. Shops, die im Januar 2026 aktualisiert wurden, haben ihre alten Anpassungen restlos verloren². Wenn dein Checkout heute leer aussieht, ist das der Grund.

Was hat checkout.liquid ersetzt?

Aus einer bearbeitbaren Datei wurden vier Sandboxed Tools, von denen jedes einen Teil dessen übernimmt, was checkout.liquid früher abgedeckt hat.

• Checkout UI Extensions rendern benutzerdefinierte Interfaces an definierten Zielen (Targets) im Checkout sowie auf den Danke- und Bestellstatus-Seiten.⁵
• Shopify Functions führen die Backend-Logik aus: Rabatte, Anpassungen von Versand und Zahlung sowie Validierung von Warenkorb und Checkout.⁶
• Die Branding API stylt den Checkout durch Design-Token, die mit der Mutation checkoutBrandingUpsert in der GraphQL Admin API festgelegt werden.⁷⁸
• Web Pixels abonnieren Kunden-Events in einer Sandbox und ersetzen das Feld für Additional Scripts für das Tracking.⁹

Der Leitfaden zur Checkout Extensibility behandelt jedes Tool im Detail. Was du hier brauchst, ist die Zuordnung.

Schritt 1: Überprüfe, was dein checkout.liquid eigentlich gemacht hat

Bevor du irgendetwas neu baust, erstelle eine einfache Liste mit jeder Aufgabe, die der alte Checkout übernommen hat. Die meisten Plus-Checkouts haben über Jahre hinweg Snippets angesammelt, die niemand dokumentiert hat.

Sammle die Beweise aus drei Quellen:

1. Die alte checkout.liquid Datei, die bei Themes, die eine hatten, immer noch im Code-Editor sichtbar ist. Lies sie von oben bis unten durch und notiere jeden nicht-standardmäßigen Block.
2. Das schreibgeschützte Feld für zusätzliche Skripte (additional scripts), das genau die Tags bewahrt, die früher auf den “Vielen Dank”- und Bestellstatus-Seiten ausgelöst wurden.²
3. Deine App-Liste. Jede App, die Skript-Tags in den Checkout injiziert hat, hörte zu den Einstellungsdaten (Sunset-Daten) auf zu funktionieren. Prüfe also jede App, die mit dem Checkout zu tun hat, auf eine Version, die für Extensibility bereit ist.

Sortiere jede Entdeckung in einen von acht Bereichen: Tracking, Trust-Content, Custom Fields (benutzerdefinierte Felder), Upsells, Validierung, Rabatt- und Versandlogik, Styling, Header und Footer. Jeder Bereich entspricht einer Zeile der obigen Tabelle.

Dann miste aus (prune). Eine Migration ist der günstigste Moment, den du jemals bekommen wirst, um das Pixel einer stillgelegten Werbeplattform oder das Badge für eine abgelaufene Zertifizierung rauszuwerfen. Baue nur das neu, was sich seinen Platz auf der konversionsstärksten Seite, die du besitzt, noch verdient.

Schritt 2: Baue die Händler-Seite in einem Checkout-Entwurf neu

Das Shopify-Admin nennt die Einheit der Checkout-Anpassung eine Checkout-Konfiguration. Die Admin API nennt sie weiterhin ein Checkout-Profil, weshalb die Branding-Mutation eine checkoutProfileId erfordert.⁸ So oder so ist es ein versioniertes Bündel aus Branding, Layout und Blöcken, das du als Entwurf bereitstellen und bei Bedarf veröffentlichen kannst.¹⁰

Der Ablauf im Admin-Bereich:

1. Gehe zu Einstellungen > Checkout. Klicke im Bereich Konfigurationen neben deiner aktiven Konfiguration auf Duplizieren, um einen Entwurf zu erstellen.¹⁰
2. Klicke beim Entwurf auf Bearbeiten, um den Checkout- und Kundenkonten-Editor zu öffnen.¹⁰
3. Lege dein Branding fest: Logo, Hintergrund, Farben und Schriftarten im gesamten Checkout sowie auf den Danke- und Bestellstatus-Seiten.¹¹
4. Wähle dein Layout. In den Einstellungen des Editors kannst du zwischen dem One-Page- und Three-Page-Checkout wechseln; One-Page ist der Standard.¹²
5. Füge App Blocks für Trust Badges, Upsells und eigene Inhalte hinzu und positioniere sie im Editor.
6. Klicke auf Vorschau (Preview) des Entwurfs, dann auf Veröffentlichen (Publish). Die Veröffentlichung macht ihn zur aktiven Konfiguration, und die alte aktive Konfiguration wird zu einem Entwurf, zu dem du jederzeit zurückkehren kannst.¹⁰

Nichts davon erfordert Code, und der Draft-First-Workflow bedeutet, dass der Live-Checkout nie einen halbfertigen Zustand sieht. Unser Guide zum Hinzufügen von Trust Badges zum Shopify-Checkout zeigt die blockbasierte Version der häufigsten Einzelanpassung.

Schritt 3: Verschiebe das Tracking zu Web Pixels

Tracking ist der Teil, den die meisten Plus-Shops unbemerkt verloren haben, da der Ausfall still verläuft: Der Checkout funktioniert, die Werbeplattformen erhalten nur einfach keine Conversions mehr.

Du hast zwei Ersatzmöglichkeiten für die alten Additional-Scripts-Tags.⁹

App Pixels laufen in einer strengen Sandbox und kommen von der App der jeweiligen Plattform – Google, Meta, TikTok und Co. pflegen ihre eigenen. Dies ist die Standardwahl: Der Anbieter hält sie aktuell und du benötigst dafür keinen Code.

Custom Pixels werden im Pixel-Manager des Admins eingefügt und laufen in einer etwas permissiveren Sandbox, bei der die Events-API bereits verdrahtet ist.⁹ Sie sind der Notausgang für Plattformen ohne App Pixel. Zwei Vorbehalte: Shopify weist deutlich darauf hin, dass Custom Pixels nicht unterstützt werden und dass Compliance, Sicherheit und Pflege in deiner Verantwortung liegen, und nicht alle Pixel-Funktionen innerhalb der Sandbox funktionieren.¹³

So oder so: Überprüfe mit einer echten Testbestellung, dass checkout_completed jede Plattform erreicht, die dir wichtig ist. Vor allem für Werbeplattformen solltest du das Pixel mit einem serverseitigen Pfad kombinieren; unser Leitfaden zur Meta CAPI auf Shopify behandelt Deduplizierung und Event Match Quality für genau dieses Setup.

Schritt 4: Baue Custom UI und Logik mit einem Entwickler neu

Zwei Bereiche aus deinem Audit sind echte Entwicklungsarbeit.

Custom Checkout UI Extensions

Alles, was ein App Block nicht abdecken kann – ein maßgeschneidertes Custom Field, ein bedingtes Banner, eine Umfrage auf der Danke-Seite – wird zu einer Checkout UI Extension. Extensions werden an definierten Static- oder Block-Targets gerendert, basieren auf den Checkout-Komponenten von Shopify und laufen in einer isolierten Sandbox ohne Zugriff auf das HTML der Checkout-Seite oder auf Zahlungsdaten.⁵

Extensions bei den Schritten Information, Versand und Zahlung sind ein Plus-Feature; die Targets auf der Danke- und Bestellstatus-Seite stehen allen Plänen zur Verfügung.⁵ Ein Entwickler generiert das Grundgerüst (Scaffolding) mit der Shopify CLI und testet es gegen einen Development Store, und der Händler platziert Block-Target-Extensions im selben Checkout-Editor wie in Schritt 2.

Shopify Functions

Regeln für das Stapeln von Rabatten (Discount stacking), das Umschreiben von Versandtarifen und das Einschränken von Zahlungsmethoden (Payment method gating), die früher in Shopify Scripts lagen, leben jetzt in Shopify Functions, die zu WebAssembly kompiliert und während des Checkouts auf der Infrastruktur von Shopify ausgeführt werden.⁶ Function-APIs decken Rabatte, Versand- und Zahlungsanpassungen, Warenkorb- und Checkout-Validierung, Order Routing und mehr ab.⁶

Da Shopify Scripts ab dem 30. Juni 2026 nicht mehr ausgeführt wurden, läuft jeder Shop, der diese Portierung übersprungen hat, seit dem 30. Juni 2026 ohne diese Logik.⁴ Wenn Margen oder Versandtabellen seitdem falsch aussahen, fang hier an.

Shopify veröffentlicht Templates für Rust und JavaScript und empfiehlt Rust für die Performance bei großen Warenkörben.⁶ Bevor du Custom Functions in Auftrag gibst, prüfe, ob eine Rabatt- oder Versand-App die Logik bereits als Konfiguration mitbringt – bei gängigen Regeln ist das meistens der Fall.

Was keinen 1:1-Ersatz hat

Ein ehrlicher Migrationsplan benennt die Lücken. Vier Dinge aus der checkout.liquid-Ära kommen nicht zurück.

Beliebige Änderungen am Checkout-Markup. Extensions können das HTML der Seite überhaupt nicht verändern – sie rendern innerhalb ihrer eigenen Sandbox an den Zielen, die Shopify definiert.⁵ Wenn dort, wo dein altes Snippet gerendert wurde, kein Target existiert, gibt es keine Möglichkeit, es dort zu rendern. Der Workaround ist das nächstgelegene Target, oder du verschiebst das Element auf die Warenkorb-Seite (Cart Page), wo dein Theme immer noch das Sagen hat.

Styling pro Seite. Das Branding gilt für den Checkout, Checkout UI Extensions und Kundenkonto-Seiten (Customer Account Pages) gleichermaßen; Shopify unterstützt ausdrücklich kein Styling einzelner Seiten.⁸ Du designst einmal für den gesamten Flow.

Scripte, die das Checkout-DOM benötigten. Session-Recording, einige A/B-Testing-Tools und ältere Affiliate-Tags lesen die Seite direkt aus, und die Pixel-Sandbox lässt das nicht zu.¹³ Frage jeden Anbieter nach seinem App Pixel oder einer serverseitigen Integration; wenn beides nicht existiert, ist dieses Tool im Checkout erledigt.

Freie Netzwerkaufrufe in der Logik. Functions können externe Dienste nicht direkt aufrufen. Es gibt einen Fetch-Target-Mechanismus, bei dem Shopify einen deklarierten HTTP-Request im Namen der Function ausführt. Dieser muss jedoch von Shopify aktiviert werden und ist auf Enterprise-Vereinbarungen und bestimmte Anwendungsfälle beschränkt.¹⁴ Der Standard-Workaround ist die Vorausberechnung von Daten in Metafelder, die die Function lesen kann.

Wenn eine dieser Lücken ein Kernbestandteil deines Checkouts ist, entscheide dich jetzt für einen Workaround und nicht erst mitten im Neuaufbau.

Was das Upgrade dir bringt

Der Gegenwert für diese Einschränkungen ist real, und das ist der Grund, der alten Datei nicht nachzutrauern.

Ein schnellerer Checkout mit besseren Conversions. Shopify berichtet, dass der hauseigene Checkout im Durchschnitt 15 % besser konvertiert als die Konkurrenz, in der Spitze sogar um bis zu 36 %, und verweist auf eine 2023 durchgeführte Studie mit einer großen Unternehmensberatung.¹⁵ Diese Zahlen stammen von Shopify selbst, aber die Richtung stimmt mit unseren Beobachtungen überein: Weniger Custom Code im Checkout bedeutet weniger Ballast, der ihn verlangsamt.

Shop Pay auf den aktuellen Systemen. Shopify meldet, dass der Shop Pay-Checkout bis zu dreimal schneller ist und eine bis zu 50 % höhere Conversion Rate bietet als der Standard-Checkout.¹⁵

One-Page-Checkout als Standardlayout, mit der Möglichkeit, per Klick wieder zu drei Seiten zurückzuwechseln, falls deine Daten etwas anderes nahelegen.¹²

Updates werden von Shopify übernommen. Das ist der unscheinbare Vorteil. Shops, die auf checkout.liquid liefen, befanden sich auf einer Maintenance-Version, die nie automatisch neue Checkout-Features erhielt.³ Mit Extensibility kommunizieren deine Anpassungen mit versionierten APIs, sodass Shopify unter der Haube Checkout-Verbesserungen ausliefern kann, ohne etwas zu beschädigen.

Das Timing für den Neuaufbau vor BFCM

Arbeite rückwärts vom Black Friday, 27. November 2026.

• Noch acht Wochen: Schließe das Audit und den Händler-seitigen Rebuild in einer Entwurf-Konfiguration (Draft) ab. Gib zu diesem Zeitpunkt alle benutzerdefinierten Extensions und Functions in Auftrag, da sich die Warteschlangen der Entwickler vor der Hochsaison füllen.
• Noch sechs Wochen: Veröffentliche es, gib dann Testbestellungen auf und überprüfe jeden Pixel, jede Function und jedes Feld bei einer Live-Bestellung.
• Noch zwei Wochen: Freeze. Der Checkout ist der schlechteste Ort, um während der Hochsaison Änderungen auszuliefern (zu shippen); behalte einen Rollback-Draft der funktionierenden Konfiguration.¹⁰

Ein Checkout, der sechs Wochen vorher veröffentlicht wurde, hat Wochen voller echter Bestellungen, um sich vor dem Black Friday zu bewähren. Einer, der in der Woche davor veröffentlicht wird, nicht.

Wenig Zeit? Veröffentliche vor dem Freeze nur das, was du bei echten Bestellungen testen kannst, wie Branding, App Blocks und Pixel, und lass die benutzerdefinierten Extensions und Functions bis nach dem Cyber Monday am 30. November warten.

Wie Fudge ins Spiel kommt

Checkout Extensions, Functions und Pixel haben ihre eigene Toolchain, und Fudge baut sie nicht.

Fudge ist der AI-Operator für Shopify-Shops, und worum er sich kümmert, ist alles, was der Käufer vor dem Checkout sieht: die Landingpages, Produktseiten, den Warenkorbinhalt und die Trust-Sektionen, die darüber entscheiden, ob der Checkout überhaupt einen Besucher abbekommt. Beschreibe die Änderung in einfacher Sprache, wie zum Beispiel “Füge unter dem In-den-Warenkorb-Button eine Zeile mit kostenlosem Versand, unserem Rückgabefenster und den akzeptierten Zahlungsmethoden hinzu”, und der Store Editor von Fudge schreibt natives Liquid, CSS und JavaScript in deinem Theme als Draft (Entwurf), den du in der Vorschau ansehen und veröffentlichen kannst – dasselbe Draft-First-Muster, das auch der Checkout-Editor verwendet. Mit einem Conversion-Ziel sucht Fudge außerdem nach den Seiten, auf denen Käufer abspringen, bevor sie den Checkout erreichen, und vergleicht die Conversion Rate vor und nach jedem Fix.

Während ein Entwickler deine Checkout Extensions neu baut, muss die Page Builder Seite der BFCM-Vorbereitung nicht auf sie warten.

FAQ