New tax fields for return shipping fees in the GraphQL Admin API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on October 01, 2026.
This Shopify update is categorized as API, New, GraphQL Admin API, 2026-10.
What changed
As of API version 2026-10, the GraphQL Admin API exposes the tax amounts calculated for return shipping fees. These amounts reflect the tax calculated by the merchant's tax provider for the fee. What's new CalculatedReturnShippingFee.taxAmountSet (MoneyBag!) — the estimated tax on the return shipping fee, in shop and presentment currencies. Available on the returnCalculate query, and zero when no tax applies to the fee. ReturnShippingFee.finalizedTaxAmountSet (MoneyBag) — the tax charged on the return shipping fee, locked in when the return is processed.
Who is affected
Apps using the affected Shopify GraphQL API surface should review this change.
What action may be needed
Review whether the new capability is relevant to your app. If you plan to use it, test the affected API or workflow before adopting it in production.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →