API Changelog Brief

Shopify API changes, October 2026: what changed

43 entries from Shopify's public changelog, published 2026-09-05 to 2026-10-05, newest first. By type: breaking: 9, deprecation: 3, change: 12, new: 19.

Dated changelog posts are covered. The aggregate 2026-10 release-notes page was not broken down into entries, so a change that appears only there is missing from this list.

Only the breaking changes and deprecations: Shopify API breaking changes and deprecations, Sep 5 to Oct 5, 2026.

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

DateTypeChange
2026-10-01newMore control over commerce updates with Next Gen Events
Next Gen Events, the successor to classic webhooks, are generally available in API version 2026-10 with declarative subscriptions that use triggers, GraphQL queries and filters; classic webhooks keep working.
2026-10-01newRollouts queries and webhooks in the Admin GraphQL API
API version 2026-10 adds rollouts and rollout queries plus rollout webhooks to the Admin GraphQL API.
2026-10-01changeDiscounts can now be included in Rollouts
In 2026-10, discount types expose a read-only rollouts connection because discounts can now be part of a Rollout.
2026-10-01newOrders webhooks now include selling_plan_id on line items
From API version 2026-10, orders webhook payloads include selling_plan_id on each line item.
2026-10-01newNew fiscalDeviceIdentifier field on PointOfSaleDevice
PointOfSaleDevice gains a nullable fiscalDeviceIdentifier field in API version 2026-10.
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-01newAdded parseWarnings to ShopifyqlQueryResponse
ShopifyqlQueryResponse adds a parseWarnings field in API version 2026-10.
2026-10-01changeThe orderCancel mutation now returns a structured jobResult
In 2026-10 the orderCancel mutation also returns a structured jobResult, while the existing job field is unchanged.
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-01newNew SubscriptionContractCalculation API for subscription management
2026-10 introduces the SubscriptionContractCalculation API, which supports Functions and lets you preview contract changes before saving them.
2026-10-01changeInventory shipment webhooks include inventory transfer IDs
From 2026-10, inventory shipment webhook payloads include inventory_transfer_id.
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-30newUse app intents for your discount app
Discount apps can register create and edit app intents for shopify/Discount.
2026-09-29changeMore resilient token exchanges when migrating tokens without a user session
When migrating a non-expiring token, the exchange can be retried with the original token for seven days and returns the same access and refresh token pair.
2026-09-29newManage packed product dimensions with the Admin GraphQL API
API version 2027-01 adds packedDimensions to InventoryItemMeasurement and its input.
2026-09-29newMove existing subscriptions to Shopify App Pricing
Existing app subscriptions can be moved to Shopify App Pricing with a Partner Dashboard migration tool or a Shopify CLI command.
2026-09-28changeSidekick can now invoke app intents without tools
App extensions that only expose intents are now eligible to be invoked by Sidekick.
2026-09-28newWebMCP support for checkout
Checkout exposes WebMCP tools for reading, updating and completing a checkout and for returning to the storefront.
2026-09-25changeAI Toolkit skills have been consolidated to `shopify`
The separate shopify-* AI Toolkit skills are merged into a single shopify skill.
2026-09-25changeShopify Payments Balance Transaction GraphQL type supports currency conversion type
ShopifyPaymentsTransactionType adds a CURRENCY_CONVERSION value in API version 2026-10.
2026-09-24newPolaris 2.0 release candidate
A Polaris 2.0 release candidate is available for embedded App Home, and the entry says Built for Shopify apps must update by May 1, 2027.
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-22newPolaris CDN 1.1 is now stable
Polaris CDN 1.1 is stable, adding EmptyState, Number and Progress components and new props; apps on the unpinned script update automatically.
2026-09-22breakingRemoving marketCurrencySettingsUpdate mutation
The marketCurrencySettingsUpdate mutation is removed in API version 2027-01.
2026-09-21changeUnlimited private plans and target stores in Shopify App Pricing
Shopify App Pricing removes the previous caps on private plans and target stores.
2026-09-21newNew translatable boolean field for Metafield GraphQL Object
2026-10 adds a translatable boolean on the Metafield object, replacing the deprecated TranslatableResourceType.METAFIELD approach.
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-17changeRequest a bundle size exception for existing UI extensions
Existing UI extensions that exceed the compressed JavaScript bundle limit can request an exception through a form that asks for the minified bundle and an esbuild metafile.
2026-09-17newAdding a canceled receive action to the inventory shipments API
2026-10 adds a CANCELED receive action to inventory shipments, with canceled quantity fields on the API and in webhooks.
2026-09-17breakingRemoved session.currentSession.staffMemberId from POS UI Extensions (2026-10)
POS UI Extensions 2026-10 removes session.currentSession.staffMemberId.
2026-09-17newQuery market hierarchies with the GraphQL Admin API
2026-10 adds a marketRelationships query and parent and child market fields on Market; the read_markets scope is required.
2026-09-17newNew Pricing audit trail for contextual product variant prices
2026-10 adds auditTrail to ProductVariantContextualPricing, listing the price adjustments behind a contextual price.
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-15newFilter Catalog search results by media type
Catalog search, product and lookup tools can return video and 3D media, with a media filter for image, video or model_3d.
2026-09-15changeDynamic complexity cost for `metafieldsSet` mutation
The metafieldsSet mutation no longer costs a flat 10 points; its cost now depends on the distinct owner resources in the request.
2026-09-15changePrepare your app for the Shopify admin's new look
The Shopify admin is getting a new visual design; extensions adopt it automatically, while custom app UIs keep the old styles until they move to Polaris 2.0.
2026-09-15changefamily_name is optional for B2B orders in Payments Apps API requests
For B2B orders, family_name in the shipping and billing address of Payments Apps API requests may be absent.
2026-09-15newDelivery options in Shopify Functions input now expose their metafields
In 2026-10, CartDeliveryOption in Shopify Functions input exposes a metafield field by namespace and key.
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-09newCreate and delete dev stores in Shopify CLI
Shopify CLI 4.8 adds commands to create, delete, list and inspect dev stores.
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.