Hi everyone,
We’re changing how Shopify handles tax when an app updates an order’s shipping address.
Starting August 31, when an app changes the shipping address on an entirely unfulfilled order, Shopify will recalculate tax against the new destination. This keeps the order’s tax lines and totals accurate after the address changes.
Previously, the new shipping address was saved, but the original tax lines remained unchanged. That would leave the order’s totals out of sync with where the order is shipping.
This change applies to:
- GraphQL Admin API
orderUpdate - Admin REST API order update endpoint
- All Admin API versions
You don’t need to change your request. If your app depends on tax lines, total tax, order totals, payment status, fulfillment, or accounting logic after updating a shipping address, re-fetch the order after the order update and use the recalculated values.
For partially fulfilled orders, the address change will still be saved, but tax will not be recalculated. Recalculating tax after partial fulfillment can produce incorrect totals because fulfilled units can’t always be reliably matched back to specific line items.
Apps subscribed to orders/edited will receive a webhook when an address change results in tax recalculation.
FAQ
Does this affect REST API updates too?
Yes. This applies when an app updates an order’s shipping address through either GraphQL Admin API orderUpdate or the Admin REST API order update endpoint.
Does this apply to all API versions?
Yes. We’re treating this as a bug fix, so the change will apply to all Admin GraphQL API and Admin REST API versions.
Do I need to change my request?
No. You can keep sending the same update request. After updating the shipping address, re-fetch the order if your workflow needs current taxLines, totalTax, or order totals.
Will webhooks fire?
Yes. Apps subscribed to orders/edited will receive a webhook when the address change results in tax recalculation.
What should I check before this change ships?
Review any workflow where your app updates an order’s shipping address and then depends on tax lines, total tax, order totals, payment status, or downstream fulfillment/accounting logic.
To learn more, see the orderUpdate mutation.
Thank you,
Shopify