---
title: OrderStagedChange - GraphQL Admin
description: A change that has been applied to an order.
api_version: 2026-04
api_name: admin
type: union
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/unions/OrderStagedChange'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/unions/OrderStagedChange.md
---

# Order​Staged​Change

union

Requires `read_order_edits` access scope.

A change that has been applied to an order.

## Fields with this union

* [Calculated​Line​Item.stagedChanges](https://shopify.dev/docs/api/admin-graphql/latest/objects/CalculatedLineItem#field-CalculatedLineItem.fields.stagedChanges)

  OBJECT

  A line item involved in order editing that may be newly added or have new changes applied.

* [Calculated​Order.stagedChanges](https://shopify.dev/docs/api/admin-graphql/latest/objects/CalculatedOrder#field-CalculatedOrder.fields.stagedChanges)

  OBJECT

  An order during an active edit session with all proposed changes applied but not yet committed. When you begin editing an order with the [`orderEditBegin`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderEditBegin) mutation, the system creates a [`CalculatedOrder`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CalculatedOrder) that shows how the [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) will look after your changes. The calculated order tracks the original order state and all staged modifications (added or removed [`LineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem) objects, quantity adjustments, discount changes, and [`ShippingLine`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShippingLine) updates). Use the calculated order to preview the financial impact of edits before committing them with the [`orderEditCommit`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderEditCommit) mutation.

  Learn more about [editing existing orders](https://shopify.dev/docs/apps/build/orders-fulfillment/order-management-apps/edit-orders).

* [Order​Staged​Change​Connection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/OrderStagedChangeConnection#returns-nodes)

  CONNECTION

  An auto-generated type for paginating through multiple OrderStagedChanges.

* [Order​Staged​Change​Edge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderStagedChangeEdge#field-OrderStagedChangeEdge.fields.node)

  OBJECT

  An auto-generated type which holds one OrderStagedChange and a cursor during pagination.

***

```graphql
union OrderStagedChange = OrderStagedChangeAddCustomItem | OrderStagedChangeAddLineItemDiscount | OrderStagedChangeAddShippingLine | OrderStagedChangeAddVariant | OrderStagedChangeDecrementItem | OrderStagedChangeIncrementItem | OrderStagedChangeRemoveDiscount | OrderStagedChangeRemoveShippingLine
```