If you’ve been handling returns on your Shopify store, you’ve just gotten a new line item to worry about: tax on return shipping fees. Effective October 23 2026, Shopify Tax (and the Tax Platform) will automatically calculate and collect sales tax on the cost of shipping items back to you, just like it does for outbound shipping. This change removes the old manual workaround of adjusting tax settings or issuing refunds for under‑collected tax, but it also means you need to understand how it works and what, if anything, you need to update in your store or integration code.
What Exactly Changed?
Previously, Shopify only applied sales tax to the original shipping charge when an order was fulfilled. When a customer returned an order, the shipping fee was refunded without any tax impact, even though many U.S. states consider return‑shipping services taxable. Starting the October 23 deadline, Shopify will treat the return‑shipping fee as a separate taxable line item. The platform will estimate the tax when you create the return and will finalize the amount when you process it. Those taxes automatically flow into your standard tax reports, so you don’t have to manually reconcile them.
Who Is Affected?
Merchants – Any Shopify store that sells to U.S. addresses and uses Shopify Tax or the Tax Platform will see this new tax line on returns. If you’ve set up state‑specific shipping tax rules (e.g., untaxed shipping in a particular state), those rules still apply to the return‑shipping fee. In other words, the same tax‑exempt settings you already have will carry over to returns.
Developers – Apps or custom integrations that query order, return, or tax data via the Admin API, GraphQL API, or webhooks will now receive an additional tax component attached to the return object. If your code assumes that returns have no tax fields, you may need to add null‑checks or update your data models to avoid errors.
Tax Service Providers – If you’ve built a custom tax calculation service using Shopify’s Tax Platform, the platform will now send a “return_shipping_tax” field that you must incorporate into your calculation logic.
How Shopify Calculates Return‑Shipping Tax
The calculation uses the same rate tables and exemptions you’ve configured for outbound shipping, so there’s no need to set a separate rate for returns.
Actionable Steps for Merchants
*Review your shipping‑tax settings* – Navigate to Settings → Taxes and duties → Shipping tax. Confirm that each state’s rule reflects your business policy (taxed vs. untaxed). No new configuration is required, but a quick audit prevents surprises.
*Update your refund workflow* – If you use a custom refund app or a manual spreadsheet, add a column for “Return shipping tax” so that refunds reconcile with the numbers Shopify records.
*Communicate with customers* – Some shoppers may notice an extra tax line on their return receipt. A brief FAQ on your Returns page explaining that the tax is mandated by state law can reduce confusion.
*Check your tax reports* – After the first few weeks of the rollout, download the “tax_report.csv” from the Tax settings page. Verify that the “shipping_tax” column now includes entries for return shipments.
*Prepare for accounting* – Because the tax is now part of the refund transaction, your bookkeeping software should treat it the same way as outbound shipping tax. If you use an integration like QuickBooks Online, ensure the mapping includes the “shipping_tax” field on refund transactions.
Actionable Steps for Developers
Admin API (REST) – The Return object now contains a shipping_tax_amount field (in cents). Example fetch:
GET /admin/api/2026-10/returns/1234567890.json
{
"return": {
"id": 1234567890,
"order_id": 987654321,
"shipping_tax_amount": 125,
"total_tax": 850,
...
}
}
If your integration previously ignored shipping_tax_amount, add it to any tax‑summary calculations.
GraphQL API – The Return type now exposes shippingTaxAmount { amount currencyCode }. Sample query:
graphql
query GetReturn($id: ID!) {
return(id: $id) {
id
shippingTaxAmount {
amount
currencyCode
}
totalTax {
amount
currencyCode
}
}
}
Webhooks – The returns/create and returns/fulfill payloads include the new tax fields. Update your webhook listener to parse shipping_tax_amount and store it if you maintain a separate analytics DB.
Tax Platform integrations – When you receive the TaxCalculation request for a return, the request payload now includes a return_shipping line item with its own taxable_amount. Ensure your service returns a matching tax_amount for that line.
Liquid templates – If you display refund details in an email or order status page, you can now reference {{ refund.shipping_tax }} (available in the refund object) to show the exact tax charged on return shipping.
Best Practices & Common Pitfalls
*Don’t double‑tax* – Because Shopify auto‑applies the tax, avoid adding a manual tax line in custom apps. Doing so will cause the customer to be over‑charged and could trigger compliance issues.
*Watch for state‑specific exemptions* – Some states (e.g., New York) exempt shipping on certain goods. Your existing exemption rules still apply, but double‑check that the exemption logic is applied to the return‑shipping line as well.
*Test in a sandbox store* – Before the October 23 go‑live, create a test order, issue a return, and verify the tax appears as expected in both the admin UI and via the API.
*Update documentation* – If you provide internal SOPs or client guides about refunds, add a section titled “Return shipping tax” so support teams know what to expect.
*Monitor the tax dashboard* – The Shopify Tax dashboard now aggregates return‑shipping tax under the “Shipping” category. Set up a daily email alert if the total spikes unexpectedly; it could indicate a misconfiguration in your shipping‑tax settings.
Conclusion & Call to Action
The addition of tax on return‑shipping fees is a small but important compliance shift for U.S. merchants using Shopify Tax. By confirming your shipping‑tax settings, updating refund workflows, and tweaking any custom integrations to handle the new shipping_tax_amount fields, you’ll stay ahead of the October 23 deadline and avoid unexpected tax liabilities. Need a hand updating your API calls or adjusting your accounting sync? Reach out to our Shopify Partner team or drop a comment below – we’re happy to help you make the transition seamless.
