detektu
Shopify API changes
Info

New tax fields for return shipping fees in the GraphQL Admin API

doc:019fb619-9b4a-74ac-a83e-3ffa98844fb4::feed/https://shopify.dev/changelog/new-return-shipping-fee-tax-fields
Product
Shopify Admin GraphQL API
Source
Feed
Change kind
Feed Entry
Detected
Last updated

Deterministic evidence

Before / after

Extracted from Shopify's published contract. Open the source ↗

−1+81 change

1 / 1
null
{
"content_hash": "5c1077c47ad521d3a21335d205add726e7d1310eb1b84bce49b86147d8b7dd8d",
"excerpt": "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…",
"identity": "https://shopify.dev/changelog/new-return-shipping-fee-tax-fields",
"link": "https://shopify.dev/changelog/new-return-shipping-fee-tax-fields",
"published_at": "2026-10-01T04:00:00Z",
"title": "New tax fields for return shipping fees in the GraphQL Admin API"
}

Interpreted documentation change

What the vendor announced

The evidence describes a new tax field addition for return shipping fees in the GraphQL Admin API starting with API version 2026-10, introducing CalculatedReturnShippingFee.taxAmountSet and ReturnShippingFee.finalizedTaxAmountSet to reflect tax amounts on return shipping fees within the GraphQL Admin API.

New tax fields for return shipping fees in the GraphQL Admin API 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…

Deadline Oct 1, 2026Vendor source ↗

Monitored for you

Does this change affect your integration?

Choose the operations and fields your services use. Detektu matches Shopify findings to that declared usage so your team can review the relevant evidence. No agent or repository access required.

Monitor Shopify free See pricing

Multi-source correlation

Other Shopify findings correlated with this change across sources.

  1. Info
    SDK release 15.0.1sdk:npm/@shopify/shopify-api@15.0.1
    Shopify Admin GraphQL API
  2. Deprecation
    SDK version 13.0.0 yankedsdk:npm/@shopify/shopify-api@13.0.0
    Shopify Admin GraphQL API
  3. Info
    SDK release 15.0.1sdk:npm/@shopify/shopify-api@15.0.1
    Shopify Admin GraphQL API