Tags:
- Admin GraphQL API
- 2026-01
Order editing new validations and handled userErrors
userErrorsOrder editing mutations now include additional validations. When these validations fail, the API returns relevant in the response. These changes apply to all supported API versions.
Gift card amount limit
Gift cards added with the OrderEditAddVariant mutation are now subject to a maximum value limit. Limits vary by currency but are set high enough to accommodate typical merchant use cases.
Error message
Gift card amount exceeds the limit of {limit}
Line item count limit
Orders are limited to a maximum number of active line items when using the OrderEditAddVariant and OrderEditAddCustomItem mutations. Most shops have a limit of 500 line items.
Error message
The number of line items exceeds the limit of {limit}
Line item subtotal limit
Orders now validate that the combined value of all active line items stays within the subtotal limit.
This validation already exists at checkout and now applies to order editing as well. The current limit is set high enough to avoid blocking legitimate orders in normal use.
Error message
Line item subtotal exceeds the limit of {limit}