Shopify has deprecated several Returns fields in the GraphQL Admin API version 2026-04 that are queried through ShopifyQL. These fields have been replaced with renamed versions—such as sales_reversals and reversed_quantity—that more accurately reflect their broader scope. The change recognizes that these fields capture all order adjustments, including refunds, returns, order edits, and cancellations, not just returns alone. The field definitions remain functionally unchanged; only the naming has been updated for clarity.
For Shopify app developers and merchants relying on ShopifyQL queries for analytics, this change requires attention to maintain compatibility with future API versions. If you're currently using the deprecated Returns fields, your queries will continue to work in older API versions, but you'll need to migrate to the new field names before the removal date. Understanding the full scope of what these fields measure—all order adjustments, not just returns—also helps you build more accurate analytics and reporting features.
GetShopifyToken provides reliable OAuth token management for Shopify apps, ensuring seamless authentication as you update your API integrations. Our solution helps you maintain secure access to the GraphQL Admin API during your migration to the new ShopifyQL field names.