Shopify zieht in der GraphQL Admin API eine Typenbereinigung durch, die Shopbetreiber mit automatisierten Kollektionen kalt erwischen kann. Ab der API-Version 2027-01 verschwinden die Eingabe- und Typdefinitionen für metafieldInteger als Source-Condition von Kollektionen vollständig. Wer Kollektionen bislang über ganzzahlige Metafeld-Werte steuert, muss vor dem Upgrade auf metafieldInt umstellen.
Was genau ändert sich in der GraphQL Admin API?
Der Kern liegt weniger im Namen als im Datentyp des value-Felds. Mit dem Wechsel zu metafieldInt verändert sich die Typisierung der Wertangabe in Integer-Metafeld-Bedingungen. Das ist kein kosmetisches Detail: Skripte, Custom Apps und Middleware, die Collection-Conditions per Mutation anlegen oder auslesen, laufen gegen einen Typ, den die API künftig nicht mehr kennt. Wer die abgekündigte Definition weiterverwendet, bekommt spätestens beim Versionssprung Fehler statt Daten.
Betroffen sind ausdrücklich zwei Richtungen. Erstens das Schreiben: Wer Kollektionen per API mit einer Integer-Metafeld-Regel erstellt, muss das Eingabeformat anpassen. Zweitens das Lesen: Wer bestehende Collection-Source-Conditions ausliest, um sie zu spiegeln, zu migrieren oder in eigene Systeme zu überführen, stolpert über die alten Typen.
Kein Deprecation-Zeitraum über die Versionsgrenze hinweg: Entweder migriert der Shop vor 2027-01, oder die Automatisierung bricht.
Warum verlieren Händler Zeit, wenn sie erst bei der Versionspflicht reagieren?
Shopify versioniert quartalsweise und hält alte API-Versionen mindestens zwölf Monate am Leben. Das verleitet dazu, das Thema nach hinten zu schieben. Der Fehler tritt dann nicht schleichend auf, sondern hart beim Versionswechsel, idealerweise mitten im Weihnachtsgeschäft oder kurz vor einer Kampagnenphase, wenn Kollektionen neu befüllt werden sollen. Wer die Migration in einem ruhigen Fenster erledigt, testet gegen die neue Version, ohne dass die Live-Kollektion ausfällt.
Der pragmatische Weg: zuerst inventarisieren, welche Kollektionen überhaupt auf Integer-Metafelder filtern. In vielen größeren Shops sind das wenige, aber kritische Regeln, etwa Staffelpreis-Buckets, Lagerkennzahlen oder kundenspezifische Sortimentsfreigaben, die über ein Metafeld „Stufe“ oder „Priorität“ gesteuert werden. Diese Regeln gilt es, einzeln auf metafieldInt umzustellen und die Rückgabe der API zu prüfen.
Welche Werkzeuge helfen bei der Umstellung?
Reine Admin-Nutzer merken von der Änderung wenig, weil die Shopify-Oberfläche die Typen intern auflöst. Spannend wird es für alle, die eigene Integrationen betreiben. Apps aus dem Bereich Metafield-Verwaltung, etwa Metafields Guru oder die Metafield-Dienste von Matrixify, sind hier nützliche Prüfinstanzen, weil sie die vorhandenen Definitionen sichtbar machen und Massenänderungen erlauben. Wer eine individuelle Anbindung an ERP oder PIM betreibt, sollte den zuständigen Entwickler früh einbinden und einen Testshop gegen die künftige API-Version laufen lassen.
Für Shopbetreiber ohne eigene Dev-Ressourcen lohnt der Blick in die Partner-Agentur: Die Umstellung ist überschaubar, aber sie verlangt API-Zugriff und ein Verständnis dafür, dass hier keine Funktion wegfällt, sondern ein Typname. Bis 2027-01 bleibt Zeit, wer sie nutzt, tauscht einen Typbezeichner und ist fertig. Wer sie verstreichen lässt, sitzt irgendwann vor leeren Kollektionen und sucht den Fehler an der falschen Stelle.