Reported details
What happened
Shopify’s changelog says that, in GraphQL Admin API version 2027-01 and later, sending DiscountCountriesInput.includeRestOfWorld: true returns a BAD_REQUEST error.
Affected apps must list every country where the shipping discount should apply through the countries add field. Example country codes in the changelog are illustrative, not a recommended eligibility list.
The change is specific to requests that send true: false retains its existing behavior, null remains a no-op, and apps on 2026-10 or earlier keep existing behavior while those versions are supported.
Business relevance
Why it matters
For North American merchants using apps that configure shipping discounts through this API, a version upgrade could make a discount mutation fail if the app still sends true.
Replacing a dynamic Rest of World setting with named countries makes eligibility explicit; the correct list depends on where each discount is intended to apply.
Editorial perspective
Analysis & judgment
The important distinction is the combination of API version and input value: the reported error applies to true on 2027-01 or later, not to every use of the field.
The changelog describes a compatibility change for apps, so merchants may need to confirm an app’s upgrade plan rather than edit a storefront setting themselves.
Applicability
Seller impact
North American merchants should check whether any discount-management app they use sends includeRestOfWorld: true and whether it plans to use API version 2027-01 or later.
Action plan
What to do now
- 1
Check discount app compatibility
this-weekIf you use an app that manages shipping discounts, ask its developer whether it sends includeRestOfWorld: true and how it will handle API version 2027-01 or later.
- 2
Confirm intended country eligibility
this-weekIf your app or team owns the integration, identify the full country list intended for each affected discount before replacing the setting with explicit codes.
- 3
Track the API version upgrade
monitorIf the integration remains on 2026-10 or earlier, monitor its version plan; the changelog says existing behavior continues while those versions are supported.
What not to do yet
- Do not copy the changelog’s example country codes as your eligibility list; use only the countries where the discount is meant to apply.
Sources & context
Evidence and sources
A source may provide only a headline or summary. Read the evidence scope below. Links and workflow checks are not independent fact verification. Internal confidence values are workflow signals, not probabilities of factual correctness.
- 01Source link
Starting with GraphQL Admin API version 2027-01, setting the deprecated DiscountCountriesInput.includeRestOfWorld field to true returns a BAD_REQUEST error. Apps that use this value must specify every applicable country through add before upgrading. Apps on 2026-10 and earlier keep their existing behavior while those versions are supported. 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. The codes above are only an example. Who's affected This change affects apps that send includeRestOfWorld: true through DiscountCountriesInput while using Admin GraphQL API versio
Shopify Developer Changelog · Workflow status: single-source
Retrieved: September 23, 2026 at 04:07 p.m. UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.