Shopify removes the automaticDiscounts query from Admin API version 2027-01

Shopify removes the automaticDiscounts query from Admin API version 2027-01

22 September 2026 — Shopify said in its developer changelog on 18 September 2026 that the deprecated automaticDiscounts query will be removed from the GraphQL Admin API in API version 2027-01. The entry is flagged as a breaking change with action required. Apps that request version 2026-10 or earlier keep working unchanged for as long as those versions are supported.

Not yet independently verified. Rests on Shopify's own developer changelog and versioning page; no independent report was found. The 1 January 2027 date is worked out from Shopify's published quarterly schedule, not stated in the entry. We will update this when it can be confirmed, and remove this note.

What changes

From 2027-01, automaticDiscounts no longer exists on the query root, and any request that includes it fails validation instead of returning data. Two types that only this query returned, DiscountAutomaticConnection and DiscountAutomaticEdge, are removed as well, which also breaks generated types and tooling that reference them.

The replacement is discountNodes with the filter method:automatic. It returns a list of discount nodes, each carrying the discount on its discount field, and accepts similar filters, including status, discount type, discount class, creation date and start date. Shopify says existing inline fragments carry over unchanged, moved one level deeper. One query can then read both automatic and code-based discounts.

Shopify also warns that automaticDiscountNodes is itself deprecated in favour of discountNodes, so moving to it now would mean migrating a second time later.

Under Shopify's published versioning policy, a new API version is released every three months at 17:00 UTC on the first day of the quarter, which puts 2027-01 on 1 January 2027. Each stable version is supported for at least 12 months. Apps pinned to the unstable version are affected once 2027-01 becomes the latest release.

Who should care

The change matters to merchants who rely on custom apps, agency-built integrations, reporting or ERP connectors, or marketing tools that read automatic discounts, as well as to the developers who build them. An integration upgraded to 2027-01 without the change will stop seeing automatic discounts, which can quietly break promotion reporting, price checks and reconciliation.

What to do

• Ask each app vendor or agency whether their code calls automaticDiscounts, and when they will move to discountNodes.
• For in-house code, search for automaticDiscounts, DiscountAutomaticConnection and DiscountAutomaticEdge, including generated GraphQL types and schema snapshots.
• Replace the query with discountNodes using method:automatic, not automaticDiscountNodes.
• Regenerate types against 2027-01 and test in a development store, checking that results match what 2026-10 returns.
• Check Shopify's API health report, which lists resources an app needs to change.
• If you cannot migrate in time, keep the app on 2026-10 or another supported earlier version until you can, as Shopify suggests.

What the entry leaves out

The changelog entry does not give a calendar date for 2027-01; the 1 January date comes from Shopify's general release schedule. It also does not say how many apps still use the query. Apps that do not call automaticDiscounts need no change for this removal.

Sources

• Shopify developer changelog: The automaticDiscounts query is removed in API version 2027-01 — 18 September 2026
• Shopify.dev: About Shopify API versioning (read 22 September 2026) — 22 September 2026