---
title: >-
  Deprecation Notice: CalculatedOrder for committed order edits - 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/deprecation-notice-calculatedorder-for-committed-order-edits
  md: >-
    https://shopify.dev/changelog/posts/deprecation-notice-calculatedorder-for-committed-order-edits.md
metadata:
  effectiveApiVersion: 2025-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation announcement
    handle: deprecation-announcement
  indicatesActionRequired: true
  createdAt: '2024-12-02T11:53:09-05:00'
  postedAt: '2024-12-12T00:00:00-05:00'
  updatedAt: '2024-12-16T17:49:27-05:00'
  effectiveAt: '2024-12-12T00:00:00-05:00'
---

December 12, 2024

# Deprecation Notice: CalculatedOrder for committed order edits

DateDecember 12, 2024

Version[2025-04](https://shopify.dev/changelog?api_version=2025-04)

Flags[Deprecation announcement](https://shopify.dev/changelog?filter=deprecation-announcement)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

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

We are deprecating the [`CalculatedOrder`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CalculatedOrder) object for committed order edits. There are no changes to `CalculatedOrder` for uncommitted order edits. `CalculatedOrders` are temporary objects that represent an order's state with unsaved edits. Use the [`Order`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Order) object to access the current state of an order after edits are committed. To query past changes made to an order, use [`Order.agreements`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Order#connection-agreements).

As part of this change, we are also deprecating the [`CalculateOrder.committed`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CalculatedOrder#field-committed) field.

**Deprecation Schedule:**

* **Today:** `CalculatedOrders` for committed order edits are marked as deprecated. They will no longer be returned for committed order edits in the `unstable` version and the `2025-04` release candidate.
* **January 1, 2026 (version `2026-01`):** `CalculatedOrders` for committed order edits will no longer be returned. Note: If usage drops to zero before `2026-01`, we may stop returning `CalculatedOrders` in an earlier version.

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