Return
A standardized reason for returning an item.
- Shopify offers an expanded library of return reasons available to all merchants
- For each product, Shopify suggests a curated subset of reasons based on the product's category.
Anchor to FieldsFields
- deleted (Boolean!)
- handle (String!)
- id (ID!)
- name (String!)
- Anchor to deleteddeleted•Boolean!non-null
Whether the return reason has been removed from taxonomy.
Deleted reasons should not be presented to customers when creating new returns, but may still appear on existing returns that were created before the reason was deleted. This field enables graceful deprecation of return reasons without breaking historical data.
- Anchor to handlehandle•String!non-null
A unique, human-readable, stable identifier for the return reason.
Example values include "arrived-late", "comfort", "too-tight", "color-too-bright", and "quality". The handle remains consistent across API versions and localizations, making it suitable for programmatic use.
- •ID!non-nullPre-auth accessible
A globally-unique ID.
- Anchor to namename•String!non-null
The localized, user-facing name of the return reason.
This field returns the reason name in the requested locale, automatically falling back to English if no translation is available. Use this field when displaying return reasons to customers.