Updated 12 Oct 2026: 2026-10 is now stable; add final customer-segment, SMS consent and discount-rollout breaking changes and replace expired RC guidance.

Key details

  1. Shopify 2026-10 became the latest stable API on October 1, 2026; documented access runs to October 16, 2027 15:00 UTC.
  2. Unfulfilled-order shipping-address updates recalculate destination taxes; re-query balances and tax lines.
  3. Draft-order warning priceRule and legacy PriceRule types were removed; use discountTitle/discountCode.
  4. Customer Account API removed Customer.lastIncompleteCheckout and the Checkout subtree without replacement.
  5. Segment functions use MATCHES/NOT MATCHES rather than = true/= false; named relative dates are deprecated.
  6. CustomerPhoneNumber now exposes structured smsMarketingConsent; flat consent fields are deprecated.
  7. Discount rollouts require read_rollouts to inspect schedules and effective traffic allocation; startsAt/endsAt are insufficient.
  8. Carrier service registration no longer adds rates automatically to the General shipping profile.

What builders should take away

  1. Treat 2026-10 as a stable production migration and pin existing integrations to a supported version until tests pass.
  2. Run integration tests for tax recalculation, draft-order warnings, Customer Account API, shipping-profile setup, customer segment syntax and consent.
  3. Search generated GraphQL documents for priceRule, lastIncompleteCheckout, old segment booleans and named relative dates.
  4. Request read_rollouts when discount reporting or activation logic must reflect effective rollout allocation.
  5. Re-query order taxes and payment/refund balances after shipping-address updates.
  6. Verify checkout shipping rates after carrier-service registration and monitor X-Shopify-API-Version headers.

What changed

Shopify's API version 2026-10 moved from release candidate to the latest stable version on October 1, 2026. Its final official release notes retain the consequential order tax recalculation, removed draft-order and customer-account GraphQL fields, and carrier-service behavior documented during the September RC. They also flag breaking customer segment query syntax: segment functions use MATCHES and NOT MATCHES instead of = true and = false, with date offsets replacing named relative dates. CustomerPhoneNumber adds structured smsMarketingConsent and deprecates flat consent fields. Discount types now expose a rollouts connection, and apps must request read_rollouts to see schedules and effective traffic allocation: startsAt/endsAt alone no longer describe when a discount is active under a rollout. The stable API is documented as accessible until October 16, 2027 at 15:00 UTC.

Why it matters

The migration is now a production choice, not a preview test. Apps that edit unfulfilled-order addresses can change tax balances; apps with obsolete draft-order or customer-account selections can fail schema validation; segment builders can produce invalid filters; and discount tools that inspect only nominal start/end dates can misrepresent live eligibility during traffic-split rollouts. Operators should test each affected workflow before changing the API version, while remaining on supported stable versions until ready.

2026-10 has moved from release candidate to production

Shopify lists October 1, 2026 as the stable release date and October 16, 2027 at 15:00 UTC as its access cutoff. The September release-candidate window has ended; existing apps can continue using a supported older version until their migration is tested.

Order edits and removed GraphQL fields remain migration hazards

Updating an unfulfilled order's shipping address recalculates taxes for the destination, so integrations should re-read tax lines, totals and balances. Draft-order warnings no longer expose priceRule and legacy PriceRule types are removed. The Customer Account API removes Customer.lastIncompleteCheckout and its Checkout subtree without a direct replacement.

Customer segments and SMS consent require query and field changes

Segment functions now use MATCHES/NOT MATCHES instead of = true/= false, and older named date tokens are deprecated in favour of offsets such as -12m. CustomerPhoneNumber exposes structured smsMarketingConsent; flat SMS consent fields are deprecated. Apps constructing segment expressions or synchronising consent should update generated queries and tests.

Discount rollouts change what 'active' means

Discount types expose a rollouts connection with schedules and effective traffic allocation. Apps need read_rollouts permission to inspect this data. A discount's startsAt and endsAt fields alone cannot establish its effective availability during a rollout, so reporting and promotion logic must account for rollout allocation.

Carrier services still require explicit shipping-profile setup

Creating a carrier service registers it but no longer automatically adds rates to the General shipping profile. Apps should configure the appropriate carrier-calculated rate and verify checkout visibility separately.

What to watch next

  • Shopify clarifications or fixes to 2026-10 rollout, segment and consent behavior.
  • Merchant/app reports of changed tax balances after unfulfilled-order address edits.
  • Further migration guidance for SubscriptionContractCalculation and discounts under rollouts.
  • The next 2027-01 API release candidate and any newly deprecated fields.

Still unclear

  • Individual migration impact depends on which Shopify APIs, queries and checkout flows each app uses.
  • The stable release notes aggregate changes first announced across several earlier dates; October 1 is the version's production availability date, not the origin date of every change.
  • Shopify's stable release notes may receive clarifications during the support period; review version-specific documentation before each migration.

Sources

Direct reading behind this dossier.

3 sources
2026-10: Release notes (stable)
Shopify Developer primary release notes

Current stable version, support window, breaking segment query syntax, SMS consent, discount rollouts and other action-required changes.

Discussion

Discussion is reader-contributed. Comments are not part of the BTN dossier or its editorial evidence.

0 visible comments

Join the discussion

Keep comments useful and relevant. Reader contributions may be moderated and are not BTN editorial evidence.

Sign in to comment