---
title: ReturnReason - Customer API
description: >-
  The reason for returning the item.


  > **Deprecated**: This enum is deprecated in favor of
  `ReturnReasonDefinition`.

  > Use `returnReasonDefinitionId` in input objects and `returnReasonDefinition`
  in return line items instead.

  > This enum will be removed in a future API version.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/enums/ReturnReason'
  md: 'https://shopify.dev/docs/api/customer/latest/enums/ReturnReason.md'
api_name: customer
api_type: graphql
type: enum
---

# Return​Reason

enum

The reason for returning the item.

> **Deprecated**: This enum is deprecated in favor of `ReturnReasonDefinition`. Use `returnReasonDefinitionId` in input objects and `returnReasonDefinition` in return line items instead. This enum will be removed in a future API version.

## Valid values

* COLOR

  The color of the item didn't meet expectations.

* DEFECTIVE

  The item was damaged or defective.

* NOT\_​AS\_​DESCRIBED

  The item was not as described.

* OTHER

  Other reason not listed.

* SIZE\_​TOO\_​LARGE

  The size of the item was too large.

* SIZE\_​TOO\_​SMALL

  The size of the item was too small.

* STYLE

  The style of the item didn't meet expectations.

* UNKNOWN

  The reason is unknown.

* UNWANTED

  The customer changed their mind about the item.

* WRONG\_​ITEM

  The customer received the wrong item.

***

## Fields

* [Requested​Line​Item​Input.returnReason](https://shopify.dev/docs/api/customer/latest/input-objects/RequestedLineItemInput#fields-returnReason)

  INPUT OBJECT

  The input fields for a line item requested for return.

* [Return​Line​Item.returnReason](https://shopify.dev/docs/api/customer/latest/objects/ReturnLineItem#field-ReturnLineItem.fields.returnReason)

  OBJECT

  A line item that has been returned.

### Deprecated fields

* [Return​Line​Item​Type.returnReason](https://shopify.dev/docs/api/customer/latest/interfaces/ReturnLineItemType#fields-returnReason)

  INTERFACE

  Deprecated

* [Unverified​Return​Line​Item.returnReason](https://shopify.dev/docs/api/customer/latest/objects/UnverifiedReturnLineItem#field-UnverifiedReturnLineItem.fields.returnReason)

  OBJECT

  Deprecated

***

## Map

### Fields with this enum

* [Return​Line​Item.returnReason](https://shopify.dev/docs/api/customer/latest/objects/ReturnLineItem#field-ReturnLineItem.fields.returnReason)

### Inputs with this enum

* [Requested​Line​Item​Input.returnReason](https://shopify.dev/docs/api/customer/latest/input-objects/RequestedLineItemInput#fields-returnReason)