---
title: returnLineItemRemoveFromReturn - GraphQL Admin
description: Removes return lines from a return.
api_version: 2025-07
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/returnlineitemremovefromreturn
  md: https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/returnlineitemremovefromreturn.md
---

# return​Line​Item​Remove​From​Return

mutation

Requires `write_returns` access scope. Also: The user must have `return_orders` permission.

Deprecated. Use [removeFromReturn](https://shopify.dev/docs/api/admin-graphql/latest/mutations/removeFromReturn) instead.

Removes return lines from a return.

## Arguments

* return​Id

  [ID!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/ID)

  required

  The ID of the return for line item removal.

* return​Line​Items

  [\[Return​Line​Item​Remove​From​Return​Input!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/input-objects/ReturnLineItemRemoveFromReturnInput)

  required

  The return line items to remove from the return.

***

## Return​Line​Item​Remove​From​Return​Payload returns

* return

  [Return](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Return)

  The modified return.

* user​Errors

  [\[Return​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ReturnUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### returnLineItemRemoveFromReturn reference

## Mutation Reference

```graphql
mutation returnLineItemRemoveFromReturn($returnId: ID!, $returnLineItems: [ReturnLineItemRemoveFromReturnInput!]!) {
  returnLineItemRemoveFromReturn(returnId: $returnId, returnLineItems: $returnLineItems) {
    return {
      # Return fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "returnId": "gid://shopify/<objectName>/10079785100",
  "returnLineItems": [
    {
      "returnLineItemId": "gid://shopify/<objectName>/10079785100",
      "quantity": 1
    }
  ]
}
```