Shopify API 2026-10 Released: Order Tax Recalculation, Removed Fields and What to Check
Shopify released API version 2026-10 as its latest stable version on October 1, 2026. The release changes how taxes behave when an order's shipping address is edited, removes several older fields, and turns some previously silent query mistakes into errors. Stores are not affected automatically, but any custom app, private integration or connector that talks to Shopify will meet these changes when its developer moves it to the new version.
The details are in Shopify's own 2026-10 release notes, which we read on October 6, 2026. If your store depends on custom code, such as an ERP sync, a warehouse connector or a bespoke app, this is the kind of work covered by e-commerce development and customization, and it is worth scheduling rather than leaving until a version expires.
What is Shopify API version 2026-10?
It is the October 2026 quarterly release of Shopify's developer APIs, the interfaces that apps and integrations use to read and change store data. Shopify's API versioning policy says a new version is released every three months on the first day of the quarter, and that each stable version is supported for a minimum of 12 months.
As of October 6, 2026, that page lists 2026-10 as the latest version, released October 1, 2026, with support ending October 16, 2027 at 15:00 UTC. Version 2027-01 is listed as a release candidate, which means it is for testing and is not yet stable.
An app chooses which version it calls. Nothing changes for an integration until its developer updates that version number, or until the version it uses stops being supported.
What changed in Shopify API 2026-10?
Five changes in the GraphQL Admin API need attention, along with one in the Customer Account API and one in point of sale. The release notes mark each of these as breaking or as requiring action.
Order taxes are recalculated when a shipping address changes
From 2026-10, changing the shipping address on an unfulfilled order through the orderUpdate mutation recalculates taxes for the new destination. Shopify advises developers to query the updated tax lines and totals after the update and compare balances, so that any extra payment or refund is handled. This is the change most likely to matter to finance teams, because an address correction can now alter what the customer owes. Shopify documented it in a changelog entry dated July 30, 2026.
Invalid metafield filters now return an error
A query that filters by a metafield that is not valid now returns an error. Previously the API silently ignored that part of the filter. An integration that has been running with a slightly wrong filter may have been returning more records than intended, and after the upgrade it will fail instead.
Fields and error codes that were removed or deprecated
- The priceRule field is removed from draft order discount warnings, along with the legacy PriceRule object. Queries should select discountTitle and discountCode instead.
- The ITEM_NOT_STOCKED_AT_LOCATION error is removed from three inventory mutations, so code written to handle that specific error should be taken out.
- ProductVariant.barcode is deprecated in favor of a new barcodes connection that holds up to 20 typed barcodes. The old field returns only the first entry.
- In the Customer Account API, Customer.lastIncompleteCheckout is removed, and Shopify states there is no Customer Account API replacement.
- In point of sale UI extensions, session.currentSession.staffMemberId is removed, with session.staffMember as the replacement.
Who is affected by the Shopify 2026-10 release?
Businesses that run custom or private code against Shopify's APIs are affected; stores that use only Shopify's admin and public apps from the Shopify App Store generally are not, because those app developers manage their own upgrades.
The integrations most exposed are these: order management or ERP connectors that edit shipping addresses, product information systems that sync barcodes, inventory tools that adjust or move stock, anything that creates draft orders with discounts, and point of sale extensions that identify the staff member. If you are unsure whether you have any of these, the Apps section of your Shopify admin shows custom apps, and whoever built them can tell you which API version each one calls.
Does my Shopify store break on October 1, 2026?
No. A new version being released does not change the behavior of older supported versions. The breaking changes apply only to requests made against 2026-10 or later.
The risk comes later, and it is easy to miss. Shopify's versioning policy says that when an app requests a version that is no longer accessible, Shopify "falls forward" and responds using the oldest accessible stable version. In plain terms, an integration that nobody maintains does not get switched off when its version expires. It gets quietly moved to a newer version, and breaking changes it was never tested against start to apply.
As of October 6, 2026, the oldest stable version on Shopify's list is 2026-01, with support ending January 16, 2027. An integration pinned to something older than that is worth checking now.
What is new in Shopify API 2026-10 that a business can use?
Several additions are useful for operations rather than just for developers. The release notes list these among the new features:
- A mutation that emails a customer a link to add a payment method without signing in, which helps subscription and repeat-order businesses recover failed payments.
- Multiple tracking numbers when importing fulfilled orders, for shipments split across packages.
- A Shopify Payments fee details query that returns individual fees with rates and settlement amounts, which helps with reconciliation.
- A new subscription contract calculation API that replaces the older subscription draft approach.
- A price audit trail on product variants that shows the ordered adjustments behind a contextual price.
On the same day, Shopify's developer changelog also announced that its next-generation events are generally available. That is a separate item from the versioned API release.
What should a business do now?
Treat this as a planned maintenance task, not an emergency. A sensible order of work is:
- List every custom app and integration connected to the store, and record the API version each one requests.
- Ask your developer to compare each integration against the breaking changes in the 2026-10 release notes, especially address edits, metafield filters, barcodes and draft order discounts.
- Test the upgrade on a development store before production, with at least one order whose shipping address moves between tax jurisdictions.
- Agree with your finance team how a tax difference after an address change is collected or refunded.
- Put the support end date of the version you move to in a calendar, so the next upgrade is not a surprise.
Our guide to software maintenance and support explains why this kind of scheduled version work belongs in a maintenance agreement.
Quick answers
When was Shopify API version 2026-10 released?
Shopify lists API version 2026-10 as released on October 1, 2026, and as the latest stable version as of October 6, 2026. Its support ends on October 16, 2027 at 15:00 UTC.
What is the biggest breaking change in Shopify API 2026-10?
From version 2026-10, changing the shipping address on an unfulfilled order through the GraphQL Admin API recalculates taxes for the new destination. Integrations that edit addresses need to re-read the tax lines and totals and handle any payment or refund difference.
Do Shopify merchants without custom apps need to do anything?
Generally no. API versions affect apps and integrations, and developers of public apps manage their own upgrades. Merchants with custom apps, private integrations or point of sale extensions should have a developer review the release notes.
What happens if a Shopify app uses an expired API version?
Shopify's versioning policy says requests for a version that is no longer accessible fall forward to the oldest accessible stable version. The app keeps running but may behave differently, because newer breaking changes now apply to it.
How long does Shopify support each API version?
Shopify's versioning policy states that each stable API version is supported for a minimum of 12 months, with a new version released every three months on the first day of the quarter.
Conclusion
Shopify API 2026-10 is a routine quarterly release with one change that reaches beyond developers: order taxes now follow the shipping address when it is edited. The removed fields and stricter metafield filtering are small individually, but they are exactly the sort of change that breaks an unattended integration months later when its old version expires.
Entrant Technologies builds websites, web applications, mobile apps and custom software, including Shopify integrations. If you are not sure which API versions your store's custom code relies on, contact us and we will take a look.