Skip to main content

Order editing new validations and handled userErrors

Order editing mutations now include additional validations. When these validations fail, the API returns relevant userErrors 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}

Was this section helpful?