Shopify Headless und Storefront API: Was sich wirklich geändert hat und warum es wichtig ist

Wenn du seit 2024 mit einer älteren Storefront API Version arbeitest, wird es Zeit zu handeln. Shopifys Plattform entwickelt sich 2026 schnell weiter, und die Änderungen sind diesen Zyklus größer als die übliche vierteljährliche Bereinigung. Hier ist ein ehrlicher Überblick über das, was kommt, was kaputtgeht und wo die echten Chancen liegen.

Storefront API 2026-07: Was vor Oktober kaputt geht

Shopifys Summer 2026 Edition (Codename "Compass") bringt 65 Produktaktualisierungen, und die Storefront API 2026-07 Release Candidate ist diejenige, auf die sich Entwickler konzentrieren müssen. Sie führt Breaking Changes in Cart- und Product-Query-Strukturen ein, die jeden Headless-Aufbau beeinflussen, egal ob du Hydrogen, Next.js Commerce, Nuxt oder einen Custom Stack verwendest. Die alte API-Version 2024-10 wird im Oktober 2026 eingestellt und gibt Teams fünf Monate Zeit für die Migration.

Zwei Änderungen verdienen besondere Aufmerksamkeit:

• PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION Warnung. Ab 2026-07 gibt das Cart-Objekt eine PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION Warnung aus, wenn eine Cart Line ein Produkt enthält, das am Standort des Käufers nicht verfügbar ist. Jede betroffene Cart Line gibt ihre eigene Warnung zurück, mit einem Target zur Cart Line ID, damit du sie in deiner UI zuordnen kannst. Falls du über mehrere Märkte verkaufst, muss dein Frontend diese Warnungen elegant verarbeiten statt Produkte stillschweigend auszublenden.
• DELIVERY_SELECTED_OPTION_NOT_AVAILABLE Warnung. Früher wechselte das System automatisch zu einer anderen Lieferoption, wenn die vom Käufer gewählte Option nicht mehr verfügbar war (nach Änderung der Cart-Adresse oder des Inhalts), ohne jemanden zu benachrichtigen. Version 2026-07 gibt jetzt eine DELIVERY_SELECTED_OPTION_NOT_AVAILABLE Warnung aus, damit du Käufer auffordern kannst, eine neue Option zu bestätigen oder auszuwählen.

Für Hydrogen-Nutzer bietet Shopify Codemods an, die die meisten strukturellen Field-Umbenennungen übernehmen. Sie beheben aber nicht die Custom-Discount-Logik, also wenn dein Shop gestaffelte Preise, BOGO-Regeln oder marktspezifische Rabatte hat, musst du das selbst migrationieren.

Auch wichtig: Die PRIVATE und PUBLIC_READ Metaobject-Enums werden in 2026-07 entfernt. Ersetze diese vor dem 1. Juli, falls du sie verwendest.

Storefront API Versionsvergleich

Shopify Scripts ist weg. Diesmal ernsthaft.

Das wird schon seit Jahren angekündigt, aber die Frist ist jetzt real. Ab dem 15. April 2026 kannst du Shopify Scripts nicht mehr erstellen, bearbeiten oder veröffentlichen. Nach dem 30. Juni 2026 funktionieren Scripts überhaupt nicht mehr. Falls dein Shop noch auf Ruby-basierte Scripts für Custom Discounts, Line-Item-Regeln oder Shipping-Logik angewiesen ist, führt der Migrationspfad über Shopify Functions oder eine öffentliche App. Es gibt keine Verzögerung für diese Frist.

Verbesserte Auth-Flows für Headless Checkouts

Ein stilles, aber wichtiges Update aus dem jüngsten Changelog: Verbesserte Authentifizierungsflows vom Cart zum Checkout unterstützen jetzt auch hinterlegte Kreditkarten und Store Credits, was die Käufererfahrung speziell für Headless Storefronts verbessert. Das schließt eine Lücke, die jahrelang zu Reibungen in Headless-Builds geführt hat, wo authentifizierte Checkout-Features hinter dem Standard Liquid-basierten Erlebnis zurückgeblieben sind.

Verwandt: Die GraphQL Admin API enthält jetzt ein cartToken Feld im Order-Objekt, mit dem Entwickler auf das Cart-Token zugeben können, das zur Erstellung einer Bestellung verwendet wurde. Das macht es einfacher, den gesamten Funnel von einer Headless-Cart-Session bis zum Fulfillment-Record zu nachverfolgen.

Agentic Commerce ist kein zukünftiger Trend. Es läuft schon jetzt.

Das ist die größte architektonische Verschiebung, die es sich lohnt, jetzt zu verstehen, und sie schreibt einige Annahmen darüber um, was Headless überhaupt bedeutet.

Am 11. Januar 2026 kündigte Shopify seine Agentic-Commerce-Plattform an, die auf drei Säulen aufbaut: das Universal Commerce Protocol (UCP), ein offener Standard in Co-Entwicklung mit Google; pro-Store Storefront MCP Server; und einen Agentic Plan für Marken, die noch nicht auf Shopify sind. Ende März 2026 aktivierte Shopify Agentic Storefronts standardmäßig für jeden Store auf der Plattform. Deine Produkte werden bereits durch den Shopify Catalog verteilt, es sei denn, du hast dich abgemeldet.

Die Zahlen dahinter sind beträchtlich. Seit Januar 2025 ist KI-gestützter Traffic zu Shopify Stores um 8x im Jahresvergleich gewachsen, während Bestellungen von KI-gestützten Suchen um 15x zugenommen haben. Shopify-Händler sind jetzt auffindbar in ChatGPT, Microsoft Copilot, AI Mode in Google Search und der Gemini App.

UCP wird gemeinsam mit Google entwickelt und von Amazon, American Express, Etsy, Mastercard, Meta, Microsoft, Salesforce, Stripe, Target, Walmart und Visa unterstützt. Wenn eine neue KI-Plattform UCP adoptiert, sind Shopify-Händler automatisch bereit, dort zu verkaufen, ohne weitere Integration. Das Protokoll deckt Cart-Erstellung, Checkout, Zahlungen und Post-Purchase über jede Plattform und jeden Zahlungsprozessor ab.

Am 22. April 2026 stellte Shopify auch den Storefront Catalog MCP Server um, um UCP zu implementieren. Falls du eine benutzerdefinierte KI-Agent-Integration auf einer Hydrogen Storefront erstellt hast, sind die alten Tool-Namen und Endpoints veraltet, wobei die neuen ab dem 30. Mai gültig sind und alte Versionen am 15. Juni eingestellt werden.

Was das für Headless-Architektur bedeutet

Hier wird das Gespräch interessant. Das klassische Argument für Headless war: Entkopple alles für maximale Flexibilität. Das Argument hat immer noch Gewicht für Performance und Design-Kontrolle. Aber es gibt jetzt ein Gegenargument, das kommerziell wichtig ist.

KI-Agenten (ChatGPT, Gemini, Copilot) lesen strukturierte Katalogdaten und platzieren Bestellungen, ohne jemals dein CSS oder dein Custom Frontend zu laden. Falls dein Headless Stack außerhalb von Shopifys Catalog Graph sitzt, können diese Agenten deine Produkte nicht sehen. Mit Shopifys Data Plane über die Storefront API und den Catalog verbunden zu bleiben, ist das, was dich in KI-vermittelte Purchase-Funnels bringt.

Rate Limits: Bots und Agenten werden jetzt unterschiedlich behandelt

Shopify wendet jetzt strengere Rate Limits auf Bots und Agenten an, die auf die Storefront API und Shopify-gehostete Online Store Seiten zugreifen. Bots und Agenten, die ihre Anfragen nicht signieren, unterliegen den strengsten Limits. Um sich für höhere Rate Limits zu qualifizieren, müssen Betreiber Anfragen mit Web Bot Auth signieren. Falls du Crawler, KI-Agenten oder andere automatisierte Tools gegen deine Storefront betreibst, registriere dich jetzt und signiere deine Anfragen.

Wer sollte 2026 wirklich Headless gehen?

Headless ist nicht für jeden Händler richtig, und die ehrliche Antwort hat sich nicht viel geändert:

• Starker Fall für Headless: Jährliches GMV über 2 Millionen Dollar, wo Performance-Verbesserungen einen messbaren Revenue-Impact haben, in-house JavaScript-Entwickler oder ein langjähriger Agency Partner mit Hydrogen-Erfahrung, Content-Commerce Hybrid Stores, wo Editorial Content und Product Pages tiefgreifend integriert sind.
• Überspring es für jetzt: Neue Stores unter 1 Million Dollar. Meistere dein Liquid Theme erst. Die Performance-Obergrenze auf einem gut optimierten Hydrogen Build ist höher, aber die Kosten sind etwa 3-5x höher als ein traditioneller Build, App-Kompatibilität erfordert aktives Re-Engineering (viele Mid-Tier Apps im Shopify App Store bieten ab 2026 noch keinen Headless-nativen Integrationspfad), und deine Abhängigkeit von Entwicklern wird dauerhaft.

Für Shopify Plus Brands, die Headless gehen, bleiben Hydrogen und Oxygen der empfohlene Stack. Hydrogen baut auf React Router auf, unterstützt Storefront API 2026-04 mit aktuellen Features und liefert Codemods, die mit Shopifys eigenem API-Kadenz ausgerichtet sind. Falls dein Team tiefe Next.js Expertise hat, ist dieser Pfad immer noch viable, aber du besitzt die Storefront API Integration vollständig und Oxygen Hosting ist nicht verfügbar.

Die praktische Checkliste

Hier ist, was du diesen Monat tun solltest:

1. Prüfe deine aktuelle API-Version. Dokumentiere jeden Ort, wo du einen Version String hardcodierst. Falls du auf 2024-10 bist, hast du bis Oktober Zeit. Fang jetzt an, gegen 2026-07 in Staging zu testen.
2. Migriere sofort weg von Shopify Scripts. Die Juni 30 Frist ist verbindlich. Wechsle zu Shopify Functions.
3. Teste deinen Storefront MCP Endpoint auf einem Dev Store. Starte eine echte Produktsuche und lies genau, was ein KI-Agent sieht. Fehlende Policy Pages, dünne Produktbeschreibungen und unklar benannte Varianten werden Agenten gerade offenbart. Das zu beheben ist schneller und hat höheren Impact als die meisten Roadmap Features.
4. Signiere Bot-Anfragen mit Web Bot Auth, falls du automatisierte Tools gegen die Storefront API betreibst.
5. Füge Cart-Warning-Handler für PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION und DELIVERY_SELECTED_OPTION_NOT_AVAILABLE hinzu, bevor du auf 2026-07 upgradest.

Die Stores, die 2026 zurückfallen, werden nicht die sein, die das falsche Framework gewählt haben. Sie werden die sein, die das Changelog bis Oktober ignoriert haben.