The automaticDiscounts query is removed in API version 2027-01

What changed

The deprecated automaticDiscounts query is removed from the GraphQL Admin API in version 2027-01. From that version, automaticDiscounts no longer exists on QueryRoot. A request that includes it returns a validation error instead of data.

The DiscountAutomaticConnection and DiscountAutomaticEdge types are removed too, because no other fields in the schema return them.

The replacement is the discountNodes query with query: "method:automatic". It returns a connection of DiscountNode objects, and each one exposes the discount itself on its discount field. discountNodes also reads code-based discounts, so one query covers both discount methods.

Who is affected

The removal affects any app that calls automaticDiscounts and requests API version 2027-01 or later. That includes apps pinned to unstable once 2027-01 is the latest version. On those versions, the query fails validation.

It also affects tooling and generated types that reference DiscountAutomaticConnection or DiscountAutomaticEdge. Both types are removed in 2027-01, so code generated against that version will break if it still depends on them.

Who is not affected

• Apps that request 2026-10 or earlier keep working unchanged while those versions are supported.

• Apps that already read automatic discounts through discountNodes need no change.

• Apps that never call automaticDiscounts need no action for this change.

What to do

Do this before you upgrade your app to API version 2027-01. Apps that stay on 2026-10 or earlier are not affected until they upgrade.

• Search your app for automaticDiscounts. Include generated GraphQL types and any references to DiscountAutomaticConnection or DiscountAutomaticEdge.

• Replace the query with discountNodes and pass query: "method:automatic".

• Move your existing inline fragments one level deeper, onto the discount field of DiscountNode. If you read more than one automatic discount type, add one inline fragment per type on discount, or select shared fields through the interfaces those types implement.

• Regenerate your GraphQL types or schema snapshot against 2027-01 so they match the new shape.

• Run the updated queries against a development store on 2027-01 and confirm the automatic discount data matches what your app returned on 2026-10.

The method filter, along with others such as status and discount_type, is listed in the discountNodes reference. The general search syntax is documented separately on the Shopify API search syntax page.

If you can't migrate in time, keep your app on 2026-10 or an earlier supported version until you complete the change.

Before and after code

The example below shows the same request on 2026-10 and earlier, and on 2027-01. It is taken from the Shopify changelog entry.

# On 2026-10 and earlier
query {
  automaticDiscounts(first: 10) {
    nodes {
      ... on DiscountAutomaticBxgy {
        title
        status
      }
    }
  }
}

# On 2027-01
query {
  discountNodes(first: 10, query: "method:automatic") {
    nodes {
      id
      discount {
        ... on DiscountAutomaticBxgy {
          title
          status
        }
      }
    }
  }
}

The inline fragment is unchanged. It now sits on the discount field of each DiscountNode, rather than directly on nodes.

If your app reads more than one automatic discount type, the changelog says to add one inline fragment per type on discount, or to select shared fields through the interfaces those types implement.

Deadline and version support

Shopify has not announced a calendar deadline for this removal. The change breaks an app when it upgrades to API version 2027-01, not on a fixed date. The changelog post is dated 18 September 2026, but that is the announcement date, not a deadline.

The versioning page gives these dates for the versions that matter here:

• 2026-10: released 1 October 2026, accessible until 16 October 2027 at 15:00 UTC. It is listed as the latest stable version.

• 2027-01: releases 1 January 2027, accessible until 16 January 2028 at 15:00 UTC. It is currently listed as a release candidate.

An app that stays on 2026-10 or an earlier supported version keeps automaticDiscounts until that version stops being supported. Once a version is no longer accessible, Shopify falls forward and serves requests using the oldest accessible stable version. The versioning page says this applies to apps that target an inaccessible version. The sources do not say which version that would be when 2026-10 retires, so check the versioning page nearer the time.