---
title: New GraphQL fields for return management - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/new-graphql-fields-for-return-management
  md: https://shopify.dev/changelog/new-graphql-fields-for-return-management.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

July 1, 2025

Tags:

* Admin GraphQL API
* 2025-07

# New GraphQL fields for return management

We're introducing new fields to help you better manage and track returns:

### Quantity tracking fields

The following fields are now available on both `ExchangeLineItem` and `ReturnLineItem` objects:

* [`processedQuantity`](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ExchangeLineItem#field-ExchangeLineItem.fields.processedQuantity) - Tracks the quantity of a return that has been processed.
* [`processableQuantity`](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ExchangeLineItem#field-ExchangeLineItem.fields.processableQuantity) - Indicates the quantity ready for processing.
* [`unprocessedQuantity`](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ExchangeLineItem#field-ExchangeLineItem.fields.unprocessedQuantity) - Shows the remaining unprocessed quantity.

### Return timestamps

You can now retrieve important timestamps for returns:

* [`Return.closedAt`](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Return#field-Return.fields.closedAt) - The timestamp when the return was closed.
* [`Return.createdAt`](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Return#field-Return.fields.createdAt) - The timestamp when the return was created.
* [`Return.requestApprovedAt`](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Return#field-Return.fields.requestApprovedAt) - The timestamp when the return request was approved.
* [`ReverseFulfillmentOrderDisposition.createdAt`](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ReverseFulfillmentOrderDisposition#field-ReverseFulfillmentOrderDisposition.fields.createdAt) - The timestamp when the disposition was created.

### Breaking change

**`ExchangeLineItem.lineItem` is now deprecated.** Please use [`ExchangeLineItem.lineItems`](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ExchangeLineItem#field-ExchangeLineItem.fields.lineItems) instead. If an exchange line item has been processed multiple times, it will have multiple associated line items. The `lineItem` field will only return the first associated line item.

### Availability

These fields officially launched in API version `2025-07`.