---
title: >-
  Setting includeRestOfWorld to true returns an error in API version 2027-01 -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/setting-includerestofworld-to-true-returns-an-error-in-api-version-2027-01
  md: >-
    https://shopify.dev/changelog/setting-includerestofworld-to-true-returns-an-error-in-api-version-2027-01.md
metadata:
  effectiveApiVersion: 2027-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2026-09-22T17:18:40-04:00'
  postedAt: '2026-09-23T12:00:00-04:00'
  updatedAt: '2026-09-23T07:49:39-04:00'
  effectiveAt: '2026-09-23T12:00:00-04:00'
---

September 23, 2026

# Setting includeRestOfWorld to true returns an error in API version 2027-01

DateSeptember 23, 2026

Version[2027-01](https://shopify.dev/changelog?api_version=2027-01)

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

Starting with GraphQL Admin API version `2027-01`, setting the deprecated [`DiscountCountriesInput.includeRestOfWorld`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DiscountCountriesInput#fields-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:

```text
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:

```json
{
  "countries": {
    "add": ["CA", "US"],
    "includeRestOfWorld": true
  }
}
```

After, on `2027-01`:

```json
{
  "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 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. Apps on `2026-10` and earlier continue to use the existing behavior while those versions are supported.

## Why this matters

Rest of World is a legacy shipping-zone concept that is being retired as shops move to [market-driven shipping](https://shopify.dev/docs/apps/build/orders-fulfillment/market-driven-shipping/feature-preview). In that model, shipping-discount eligibility is represented by explicit countries rather than a dynamic Rest of World bucket. Requiring apps that send `includeRestOfWorld: true` to provide country codes prevents them from depending on a concept that will no longer exist.

## What to do

Before upgrading to `2027-01`:

1. Search your discount create and update mutations for `includeRestOfWorld: true`.
2. Replace it with the complete applicable country list in `add`.
3. Stop sending `includeRestOfWorld` so your app is prepared for its eventual removal from the schema.
4. Test the updated mutations against `2027-01` in a development store and confirm the discount contains the expected countries.

If you can't migrate immediately, continue using `2026-10` or another earlier supported API version until the migration is complete.

## Related docs

* [DiscountCountriesInput](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DiscountCountriesInput)
* [Create a code-based free shipping discount](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeFreeShippingCreate)
* [Build discounts in Shopify apps](https://shopify.dev/docs/apps/build/discounts)
* [API versioning](https://shopify.dev/docs/api/usage/versioning)