Shopify zieht bei der GraphQL Admin API eine stille Deprecation scharf. Ab Version 2027-01 führt das Setzen von DiscountCountriesInput.includeRestOfWorld auf true zu einem BAD_REQUEST-Fehler. Wer den Wert bislang genutzt hat, um Rabattaktionen weltweit auszurollen, muss vor dem Versionssprung jedes einzelne Land über das Feld add explizit auflisten. Andernfalls bricht der Discount-Call ab.
Der Bruch ist kein Einzelfall, sondern Teil einer längeren Bereinigung im Discount-Schema. Shopify hatte das Feld bereits als deprecated markiert, die Rückwärtskompatibilität lief jedoch weiter. Mit 2027-01 endet das. Apps auf den Versionen 2026-10 und älter behalten ihr bisheriges Verhalten, solange diese Versionen unterstützt werden – der Handlungsdruck verschiebt sich also nur zeitlich, nicht inhaltlich.
Was ändert sich konkret für Discount-Apps und Shopbetreiber?
Das Feld includeRestOfWorld war ein Bequemlichkeits-Flag: Ein einziger Boolean-Wert genügte, um Rabatte auf alle Länder außerhalb der explizit ausgeschlossenen Regionen anzuwenden. Diese Logik fällt weg. Ab 2027-01 muss die Liste der Rabattländer vollständig sein – alle Märkte, in denen der Discount greifen soll, müssen im add-Array stehen.
Für Shopbetreiber, die Discount-Apps von Drittanbietern einsetzen, bedeutet das: Der App-Anbieter muss nachziehen. Wer eigene GraphQL-Integrationen betreibt – etwa für individuelle Rabattlogik im B2B-Segment oder bei Multi-Currency-Setups – sollte die eigenen Mutationen jetzt prüfen. Die relevante Stelle ist die DiscountCountriesInput-Struktur in jeder Discount-Mutation, die Länderfilterung nutzt.
Praktisch heißt das für Teams mit internationalem Rollout: Die Länderliste muss dynamisch aus dem eigenen Markt-Setup generiert werden, statt auf einen globalen Default zu vertrauen. Das ist mehr Aufwand, aber sauberer – und deckt Fälle ab, in denen Shopify neue Märkte hinzufügt oder bestehende deaktiviert.
Warum entfernt Shopify den Rest-of-World-Flag?
Der Flag war mehrdeutig. Er ließ offen, welche Länder zum „Rest of World“ zählten, und kollidierte mit Shops, die bestimmte Regionen steuerlich oder logistisch aus Rabatten heraushalten wollten. Ein expliziter Country-Array macht die Discount-Logik deterministisch. Shopify folgt damit dem Muster früherer Deprecations, etwa bei Shipping-Zones oder Market-Bedingungen, wo vage Sammelbegriffe ebenfalls durch explizite Listen ersetzt wurden.
Für Händler ist die Änderung Teil eines größeren Trends: API-Versionen werden enger getaktet, Breaking Changes kommen schneller. Wer nicht regelmäßig in den Release Notes nach Deprecations sucht, entdeckt solche Brüche erst beim fehlgeschlagenen Checkout – oder im schlimmsten Fall gar nicht, weil Discount-Calls im Hintergrund scheitern und nur Logs davon zeugen.
Was sollten Shopbetreiber jetzt tun?
Drei Schritte sind sinnvoll. Erstens: prüfen, welche Apps im Shop Discount-Mutationen mit Länderfilterung ausführen. Zweitens: beim Anbieter nachfragen, ob die 2027-01-Kompatibilität bereits implementiert ist – das ist eine konkrete Support-Anfrage, keine allgemeine Verträglichkeitsfrage. Drittens: eigene Integrationen auf die explizite add-Liste umstellen, bevor der Versionssprung ansteht.
Der Wechsel auf 2027-01 ist nicht verpflichtend, solange 2026-10 unterstützt wird. Erfahrungsgemäß liegt dieses Fenster bei Shopify bei rund zwölf Monaten. Wer die Migration aufschiebt, tauscht Ruhe gegen ein absehbares Problem – und Discounts sind selten der Bereich, in dem man einen stillen Fehler haben möchte.
Für Shopbetreiber, die selbst keine GraphQL-Aufrufe schreiben, bleibt die Kernfrage: Weiß mein Discount-App-Anbieter von dieser Änderung? Eine kurze Mail an den Support mit dem Stichwort „API 2027-01 includeRestOfWorld“ bringt Klarheit – schneller, als es die Fehlermeldung im Live-Betrieb je könnte.