---
title: Order editing new validations and handled userErrors - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/order-editing-new-validations-and-handled-usererrors
  md: https://shopify.dev/changelog/order-editing-new-validations-and-handled-usererrors.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

December 5, 2025

Tags:

* Admin GraphQL API
* 2026-01

# 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](https://shopify.dev/docs/api/admin-graphql/latest/mutations/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](https://shopify.dev/docs/api/admin-graphql/latest/mutations/ordereditaddvariant) and [OrderEditAddCustomItem](https://shopify.dev/docs/api/admin-graphql/latest/mutations/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}`