ShopifyQL Returns fields renamed to sales reversals ahead of 2026-07 removal
ShopifyQL analytics deprecates the Returns fields in 2026-04 and replaces them with sales_reversals and reversed_quantity names covering refunds, returns, order edits and cancellations; the old names are removed in 2026-07.
Read the official Shopify source01 · Source fact
What changed
ShopifyQL analytics deprecates the Returns fields in 2026-04 and replaces them with sales_reversals and reversed_quantity names covering refunds, returns, order edits and cancellations; the old names are removed in 2026-07.
- Published
- Mar 14, 2026
- Effective
- API version 2026-04
- Deadline
- API version 2026-07
02 · Business impact
Who and what may be affected
- Operators
- Agency, Bookkeeper
- Surfaces
- Admin Api, Shopifyql Analytics
- Impact
- Reporting
- Settlement categories
- Refunds, Revenue
03 · Next action
What to check
Rename ShopifyQL queries to the sales_reversals fields and adopt the returns schema's returned_quantity and return-reason fields where physical-return detail matters.
confirmed source relationshipLast reviewed Jul 26, 2026