2026-10 and later, changing the shipping address of an eligible, entirely unfulfilled order through orderUpdate or the REST order update endpoint can recalculate taxes. After saving, re-fetch the order’s tax lines, totals and balance. An address-update success response is not proof that the previously paid amount still equals the new total.On this page
What changed
Older API versions saved the new shipping address without recalculating tax. That could leave the order taxed for the wrong destination. Shopify’s July 30, 2026 announcement bound the new behavior to API version 2026-10, released October 1. Some older third-party writeups described a universal August rollout; Shopify later clarified that this is an API-versioned change. Check the version in the actual request URL before debugging.
Which orders recalculate?
Shopify recalculates tax when an eligible order is entirely unfulfilled and can be edited. It does not automatically recalculate the whole order for partially or fully fulfilled orders; the address can still be updated. If the order is not eligible for editing, the address may save without a tax recalculation. This distinction matters for split shipments, ERP routing and customer service workflows.
Build a post-update reconciliation step
Before changing an address, record the current total, tax and outstanding balance. Perform the update, inspect mutation user errors, then fetch fresh financial data. For GraphQL, read taxLines, totalTaxSet and the relevant current total and outstanding-balance fields supported by your API version. Don’t calculate a new tax amount in your own app from the postal code; Shopify’s order is the source of truth for its recorded tax.
1. Read order status, fulfillment state, total tax and balance.
2. Update the shipping address using your pinned API version.
3. Re-fetch order financials; compare before and after.
4. If balance increased, route to approved write-off or invoice review.
5. If balance decreased, route to approved refund review.
6. Reconcile ERP and accounting from the updated order.
Shopify suggests orderMarkAsPaid for increases within an app’s approved tolerance, orderInvoiceSend for larger increases, and refundCreate when a refund is due. Those are separate financial actions, not automatic follow-ups to every address correction. Apply merchant policy and authorization checks before moving money. The orders/edited webhook can report a tax-recalculating address edit; make downstream processing idempotent and read current order state rather than relying on webhook arrival order.
Keep fulfillment and accounting separate
An address correction may also require carrier label, fulfillment-order or warehouse changes. A corrected tax total does not prove the package destination changed in an external shipping system. Reconcile both surfaces explicitly and do not create a second invoice or refund on webhook retry.
How to test this
- Create two unfulfilled test orders with a paid balance, shipping to destinations with different tax treatment.
- On API 2026-10, change one shipping address and compare
taxLines,totalTaxSet, totals and outstanding balance before and after. - Repeat using an older pinned API version to document its behavior; do not assume the admin UI and API share the same rollout.
- Partially fulfill a test order, then change its address; verify that the address saves but the whole-order tax is not recalculated.
- Replay an
orders/editedevent and confirm the ERP does not duplicate financial adjustments; confirm invoice/refund decisions require approval.

