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-Umfeld tätig und haben mit Hunderten von Shopify-Brands an ihren Storefronts gearbeitet, einschließlich Shops, die genau dieses Upgrade durchlaufen haben. Wir entwickeln Fudge, einen KI-Storefront-Editor mit einer Bewertung von 4.9 im Shopify App Store. Wir arbeiten also 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 kaputt gegangen sind und was du eigentlich gerade neu aufbaust.

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

Dein alter Code ist noch lesbar. Additional Scripts wurden nur auf “view-only” gesetzt und nicht gelöscht², und die checkout.liquid-Datei liegt möglicherweise noch im Code-Editor deines Themes. Das macht den Audit in Schritt 1 ohne Archäologie möglich.

Das Auto-Upgrade hat nichts migriert. Shops, die im Januar 2026 aktualisiert wurden, haben ihre Legacy-Anpassungen komplett verloren². Wenn dein Checkout heute kahl aussieht, dann deshalb.

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 etwas neu aufbaust, erstelle eine flache Liste aller Aufgaben, die der alte Checkout erfüllt hat. Die meisten Plus-Checkouts haben über Jahre hinweg Snippets angesammelt, die niemand dokumentiert hat.

Zieh die Beweise aus drei Orten:

1. Der alten checkout.liquid-Datei, die im Theme-Code-Editor bei Themes, die eine hatten, noch sichtbar ist. Lies sie von oben bis unten durch und notiere jeden nicht-standardmäßigen Block.
2. Dem schreibgeschützten Feld für Additional Scripts, das genau die Tags bewahrt, die früher auf den Danke- und Bestellstatus-Seiten gefeuert haben.²
3. Deiner App-Liste. Jede App, die Script-Tags in den Checkout injiziert hat, funktionierte ab den Sunset-Daten nicht mehr. Prüfe also jede App, die den Checkout berührt, auf eine Extensibility-ready Version.

Sortiere jeden Fund in einen von sechs Bereichen: Tracking, Trust-Inhalte, Custom Fields, Upsells, Validierung, Styling. Jeder Bereich entspricht genau einer Zeile in der obigen Tabelle.

Dann miste aus. Eine Migration ist der günstigste Moment, um das Pixel einer stillgelegten Werbeplattform oder das Badge für eine abgelaufene Zertifizierung loszuwerden. Baue nur das neu, was seinen Platz auf deiner conversion-stärksten Seite noch immer 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 Discount Stacking, das Überschreiben von Versandtarifen und das Ausblenden von Zahlungsmethoden, die in Shopify Scripts angesiedelt waren, leben nun in Shopify Functions. Diese werden zu WebAssembly kompiliert und laufen während des Checkouts auf der Infrastruktur von Shopify.⁶ Die Function APIs decken Rabatte, Anpassungen bei Versand und Zahlung, Validierung von Warenkorb und Checkout, Order Routing und mehr ab.⁶

Da die Scripts am 30. Juni 2026 aufgehört haben zu funktionieren, läuft jeder Shop, der diese Portierung übersprungen hat, seit zwei Monaten ohne diese Logik.⁴ Wenn Margen oder Versandtabellen seit Frühsommer falsch aussehen, solltest du hier ansetzen.

Shopify veröffentlicht Templates für Rust und JavaScript und empfiehlt Rust für eine bessere Performance bei großen Warenkörben.⁶ Bevor du Custom Functions in Auftrag gibst, prüfe, ob eine Rabatt- oder Versand-App die Logik nicht bereits als Konfiguration mitbringt – bei gängigen Regeln ist das oft 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 von Ende November rückwärts.

• September: Beende den Audit und den Neuaufbau der Händler-Seite in einer Entwurf-Konfiguration. Beauftrage jetzt alle Custom Extensions und Functions – ab Oktober füllen sich die Auftragsbücher der Entwickler.
• Anfang Oktober: Veröffentlichen, dann Testbestellungen aufgeben und jedes Pixel, jede Function und jedes Feld bei einer Live-Bestellung verifizieren.
• November: Code-Freeze. Der Checkout ist der schlechteste Ort, um während der Hochphase noch Änderungen auszuliefern; behalte einen Rollback-Entwurf der funktionierenden Konfiguration.¹⁰

Ein im Oktober veröffentlichter Checkout hat wochenlang Zeit, sich mit echten Bestellungen vor Black Friday zu beweisen. Ein Mitte November veröffentlichter hat das nicht.

Wie Fudge ins Spiel kommt

Checkout Extensions, Functions und Pixels bilden ihre eigene Toolchain, und Fudge baut diese nicht.

Was Fudge jedoch abdeckt, ist alles, was der Käufer vor dem Checkout sieht: die Landingpages, Produktseiten, Warenkorbinhalte und Trust-Sektionen, die überhaupt erst darüber entscheiden, ob ein Besucher den Checkout erreicht. Beschreibe die Änderung einfach in Alltagssprache, und Fudge generiert natives Liquid, CSS und JavaScript in deinem Theme als Entwurf, den du in der Vorschau prüfen und veröffentlichen kannst – dasselbe Draft-First-Muster, das auch der Checkout-Editor nutzt.

Während ein Entwickler deine Checkout Extensions neu aufbaut, muss die Page Builder-Seite deiner BFCM-Vorbereitung nicht auf ihn warten.

FAQ