The `automaticDiscounts` query is removed in API version 2027-01

What Changed

Shopify is removing the automaticDiscounts query from the GraphQL Admin API starting in API version 2027-01. This field, which has been deprecated for some time, will no longer exist on QueryRoot once 2027-01 becomes the active version. Any request that includes automaticDiscounts will fail after the upgrade.

Apps currently running on API version 2026-10 or earlier are unaffected and will continue to function as expected while those versions remain supported by Shopify.

Why This Matters for App Developers

Apps that read a shop’s automatic discounts via automaticDiscounts need to migrate before upgrading to 2027-01. The replacement is the discountNodes query, filtered with method:automatic to retrieve the same set of automatic discount data.

This is part of Shopify’s ongoing consolidation of discount-related queries under the discountNodes endpoint, which already handles code-based discounts through similar method filters. Developers who haven’t yet moved to this unified pattern should treat this deprecation as a signal to standardize their discount-fetching logic across both discount types.

Practical Implications

Before upgrading any app to API version 2027-01, audit your GraphQL queries for references to automaticDiscounts. Replace them with discountNodes(query: "method:automatic") or the equivalent filter syntax, and verify that the returned fields match what your app currently consumes, since discountNodes returns a different node structure than the deprecated field.

Test this migration in a development store on a pinned API version before rolling changes to production. Apps built on 2026-10 or earlier have a grace period, but should not delay the migration given Shopify’s typical yearly API version lifecycle. Review the full field mapping in the official changelog and Admin API reference before making changes.

Read the full announcement →