---
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/posts/order-editing-new-validations-and-handled-usererrors
  md: >-
    https://shopify.dev/changelog/posts/order-editing-new-validations-and-handled-usererrors.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-11-28T14:20:25-05:00'
  postedAt: '2025-12-05T12:00:00-05:00'
  updatedAt: '2026-02-05T11:02:17-05:00'
  effectiveAt: '2025-12-05T12:00:00-05:00'
---

December 5, 2025

# Order editing new validations and handled `userErrors`

DateDecember 5, 2025

FlagsNew

SurfacesAPI

Affected APIs[GraphQL Admin API](https://shopify.dev/changelog?api_type=admin-graphql)

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.

### 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}`