API Changelog Brief

Shopify API breaking changes and deprecations, Sep 5 to Oct 5, 2026

12 entries on Shopify's public changelog, published 2026-09-05 to 2026-10-05, are typed as breaking (9) or as a deprecation (3). They are listed newest first and are dated 2026-09-08 to 2026-10-01.

The data records no deadline date for any of the 12.

See also: all 43 Shopify entries, breaking changes across the four vendors and the index of this issue.

Read on 2026-10-05: https://shopify.dev/changelog

DateTypeChange
2026-10-01breaking`metafieldInteger` collection condition removed in API version 2027-01
The metafieldInteger collection condition is removed in 2027-01 and replaced by metafieldInt, whose value is a String rather than an Int.
2026-10-01deprecationSMS marketing consent now available on the CustomerPhoneNumber object
In 2026-10, SMS marketing consent moves to smsMarketingConsent on CustomerPhoneNumber; the older flat SMS consent fields are deprecated but still work.
2026-10-01breakingTax webhook summary and calculation requests now use Global IDs
From 2027-01, tax webhook summaries and calculation requests identify customers, products, variants, line items and related resources with Global IDs, alongside new admin_graphql_api_id fields.
2026-10-01breakingUpdated function syntax on the segment query language
In 2026-10 the segment query language uses MATCHES and NOT MATCHES for functions instead of = true and = false, and several named relative dates are deprecated in favor of date offsets.
2026-09-22breakingEvents subscription query complexity limit is changing to 100 points
The query complexity limit for Events subscriptions drops from 250 to 100 points; classic webhooks are not affected.
2026-09-22breakingRemoving marketCurrencySettingsUpdate mutation
The marketCurrencySettingsUpdate mutation is removed in API version 2027-01.
2026-09-18breakingThe `automaticDiscounts` query is removed in API version 2027-01
The automaticDiscounts query and its connection and edge types are removed in 2027-01.
2026-09-17breakingRemoved session.currentSession.staffMemberId from POS UI Extensions (2026-10)
POS UI Extensions 2026-10 removes session.currentSession.staffMemberId.
2026-09-16breakingUpdates to Events payloads and subscription configuration
Events payloads change fields_changed from an array to an object with added, updated and removed; two headers are removed, parent triggers need an explicit wildcard and triggers become mandatory for update subscriptions.
2026-09-10breakingDiscounts Allocator Function API developer preview has ended
The Discounts Allocator Function developer preview has ended: its register and unregister mutations are gone from the unstable API and registered functions were unregistered.
2026-09-08deprecationVariants now support multiple barcodes
In 2026-10, product variants get a barcodes connection supporting multiple barcodes; the single barcode field is deprecated but still works.
2026-09-08deprecationCustomer Address APIs now support countryCode
In 2026-10, customer address types accept and return countryCode, and territoryCode is deprecated.