Setting includeRestOfWorld to true returns an error in API version 2027-01
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 23, 2026.
This Shopify update is categorized as Action Required, API, Breaking API Change, Admin GraphQL API, 2027-01.
What changed
As of API version 2027-01, includeRestOfWorld remains in DiscountCountriesInput, but passing true returns this error: includeRestOfWorld is no longer supported. Specify the applicable country codes explicitly. Passing false retains its existing behavior, and passing null remains a no-op. Replace includeRestOfWorld: true with an explicit list of every country where the shipping discount should apply. For example: Before, on 2026-10 and earlier: { "countries": { "add": ["CA", "US"], "includeRestOfWorld": true } } After, on 2027-01: { "countries": { "add": ["CA", "US", "AU", "BR", "JP"] } } Use the country codes that match the discount's intended eligibility.
Who is affected
This change affects apps that send includeRestOfWorld: true through DiscountCountriesInput while using Admin GraphQL API version 2027-01 or later. Public apps that explicitly request unstable receive the new behavior as soon as it is deployed. Apps that send false or null aren't affected by this behavior change.
What action may be needed
Before upgrading to 2027-01: Search your discount create and update mutations for includeRestOfWorld: true. Replace it with the complete applicable country list in add. Stop sending includeRestOfWorld so your app is prepared for its eventual removal from the schema. Test the updated mutations against 2027-01 in a development store and confirm the discount contains the expected countries.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →