---
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'
metadata:
  effectiveApiVersion: 2025-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-06-17T15:46:59-04:00'
  postedAt: '2025-07-01T01:00:00-04:00'
  updatedAt: '2025-06-20T15:39:28-04:00'
  effectiveAt: '2025-07-01T01:00:00-04:00'
---

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`.