Change: Order Edit Calculation API, Filter Update, Subscription Draft Deprecation

Shopify GraphQL now exposes a requestedOrderEditCalculate query that returns the calculated financial outcome of a requested order edit, replacing the deprecated requestedEditCalculate. The orders and ordersCount queries have been updated: requested_edit_status has been renamed to requested_order_edit_status and added to the filter options. SubscriptionDraft functions and several subscriptionContract/SubscriptionDraft mutations are marked deprecated in favor of the SubscriptionContractCalculation API. New types—including BarcodeInput, BarcodeType, and calculation input objects—support barcodes on product variants and fine‑grained edit calculations. Developers should update queries to use requested_order_edit_status, migrate away from the legacy subscription draft flow, and adopt the new calculation and barcode types for their integrations.

Query Changes

➕ Added Queries (1)

requestedOrderEditCalculate

The calculated financial outcome of a requested order edit.

➖ Removed Queries (1)

requestedEditCalculate

The calculated financial outcome of a requested order edit.

🔄 Modified Queries (3)

orders

Returns a list of orders placed in the store, including data such as order status, customer, and line item details.
Use the orders query to build reports, analyze sales performance, or automate fulfillment workflows. The orders query supports pagination,
sorting, and filtering.

~ Modified argument: query

ordersCount

Returns the number of orders in the shop. You can filter orders using search syntax or a SavedSearch, and set a maximum count limit to control query performance.

Use the query argument to filter the count by criteria like order status, financial state, or fulfillment status. The response includes both the count value and its precision, indicating whether the count is exact or an estimate.

Note:
The count is limited to 10,000 orders by default. Use the limit argument to adjust this value, or pass null for no limit. Limited to a maximum of 10000 by default.

~ Modified argument: query

subscriptionDraft

Returns a Subscription Draft resource by ID.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

Mutation Changes

➕ Added Mutations (3)

requestedOrderEditCreate

Creates a requested edit on an order on behalf of a buyer.

requestedOrderEditDecline

Declines a requested edit on an order.

requestedOrderEditResolve

Resolves a requested edit on an order, marking it as completed.

➖ Removed Mutations (3)

requestedEditCreate

Creates a requested edit on an order on behalf of a buyer.

requestedEditDecline

Declines a requested edit on an order.

requestedEditResolve

Resolves a requested edit on an order, marking it as completed.

🔄 Modified Mutations (13)

subscriptionContractCreate

Creates a subscription contract draft, which is an intention to create a new subscription. The draft lets you incrementally build and modify subscription details before committing them to create the actual SubscriptionContract.

The mutation requires Customer information, billing details, and contract configuration including the SubscriptionBillingPolicy and SubscriptionDeliveryPolicy. You can specify the CustomerPaymentMethod, the MailingAddress for shipping, and subscription intervals.

After you create the draft, you can either modify it with the subscriptionDraftUpdate mutation or finalize and create the active subscription contract with subscriptionDraftCommit.

This mutation and the draft-based flow are deprecated in favor of the SubscriptionContractCalculation API.

Learn more about building subscription contracts.

⚠️ Deprecated: Use [`subscriptionContractCreateCalculate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractCreateCalculate) instead.

subscriptionContractUpdate

Creates a draft of an existing SubscriptionContract. The draft captures the current state of the contract and allows incremental modifications through draft mutations such as subscriptionDraftLineAdd, subscriptionDraftDiscountAdd, and subscriptionDraftUpdate.

Changes remain in draft state and don't affect the live contract until committed. After you've made all necessary changes to the draft, commit it using subscriptionDraftCommit to apply the updates to the original contract.

This mutation and the draft-based edit flow are deprecated in favor of the SubscriptionContractCalculation API.

Learn more about updating subscription contracts.

⚠️ Deprecated: Use [`subscriptionContractUpdateCalculate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionContractUpdateCalculate) instead.

subscriptionDraftCommit

Commits the updates of a Subscription Contract draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftDiscountAdd

Adds a subscription discount to a subscription draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftDiscountCodeApply

Applies a code discount on the subscription draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftDiscountRemove

Removes a subscription discount from a subscription draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftDiscountUpdate

Updates a subscription discount on a subscription draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftFreeShippingDiscountAdd

Adds a subscription free shipping discount to a subscription draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftFreeShippingDiscountUpdate

Updates a subscription free shipping discount on a subscription draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftLineAdd

Adds a subscription line to a subscription draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftLineRemove

Removes a subscription line from a subscription draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftLineUpdate

Updates a subscription line on a subscription draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

subscriptionDraftUpdate

Updates a Subscription Draft.

⚠️ Deprecated: Use the [SubscriptionContractCalculation API](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/migrate-to-subscription-calculation-api) instead.

Type Changes

➕ Added Types (37)

📥BarcodeInput➕ AddedINPUT_OBJECT

The input fields for barcodes that are associated with a product variant. A variant accepts up to
20 barcodes, and a given variant input can't
set both barcode and barcodes. Refer to the
ProductVariantBarcode
object for how these barcodes are returned.

📋BarcodeType➕ AddedENUM

The identifier standard that a barcode value conforms to. A single value can satisfy more than one
standard, so declare the standard that the merchant or supplier assigned. If no BarcodeType is provided,
then no standard was declared and the value is stored as entered.

Values: UPC, EAN, ISBN, GTIN, ASIN

📥CalculateRequestedOrderEditInput➕ AddedINPUT_OBJECT

The input fields to calculate the financial outcome of a requested order edit.

📥CalculateRequestedOrderEditLineItemRemovalInput➕ AddedINPUT_OBJECT

The input fields for a line item removal on a calculated edit.

📥CalculateRequestedOrderEditLineItemsInput➕ AddedINPUT_OBJECT

The input fields for the line item changes in an edit calculation, grouped by the type of change.

🏗️CalculatedRequestedOrderEdit➕ AddedOBJECT

The calculated financial outcome of an edit based on the line items requested for editing.

Fields: financialSummary, lineItems

🏗️CalculatedRequestedOrderEditLineItem➕ AddedOBJECT

The line item being processed for an edit and its calculated monetary values.

Fields: lineItem, quantity, subtotalSet, totalTaxSet

🏗️CalculatedRequestedOrderEditLineItemConnection➕ AddedOBJECT

An auto-generated type for paginating through multiple CalculatedRequestedOrderEditLineItems.

Fields: edges, nodes, pageInfo

🏗️CalculatedRequestedOrderEditLineItemEdge➕ AddedOBJECT

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

Fields: cursor, node

🏗️CalculatedRequestedOrderEditLineItems➕ AddedOBJECT

The line item changes on a calculated edit, grouped by the type of change.

Fields: removals

📋OrderDisplayRequestedEditStatus➕ AddedENUM

The order's aggregated requested edit status that's used for display purposes.
An order might have multiple requested edits, so this field communicates the prioritized status.
The OrderDisplayRequestedEditStatus enum is a supported filter parameter in the orders query.

Values: NONE, REQUESTED, RESOLVED, DENIED

🏗️ProductVariantBarcode➕ AddedOBJECT

A barcode associated with a product variant.

A variant supports up to 20 barcodes, each of
which can have a
type.
Barcode types are validated against their respective format standards.

Fields: type, value

🏗️ProductVariantBarcodeConnection➕ AddedOBJECT

An auto-generated type for paginating through multiple ProductVariantBarcodes.

Fields: edges, nodes, pageInfo

🏗️ProductVariantBarcodeEdge➕ AddedOBJECT

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

Fields: cursor, node

🏗️RequestedOrderEdit➕ AddedOBJECT

A buyer-initiated request to edit unfulfilled line items on an order.

Fields: createdAt, id, lineItems, order, requestApprovedAt ... +4 more

🏗️RequestedOrderEditConnection➕ AddedOBJECT

An auto-generated type for paginating through multiple RequestedOrderEdits.

Fields: edges, nodes, pageInfo

📥RequestedOrderEditCreateInput➕ AddedINPUT_OBJECT

The input fields for creating a requested edit.

🏗️RequestedOrderEditCreatePayload➕ AddedOBJECT

Return type for requestedOrderEditCreate mutation.

Fields: requestedOrderEdit, userErrors

🏗️RequestedOrderEditCreateUserError➕ AddedOBJECT

Errors related to creating a requested edit.

Fields: code, field, message

📋RequestedOrderEditCreateUserErrorCode➕ AddedENUM

Possible error codes that can be returned by RequestedOrderEditCreateUserError.

Values: NOT_FOUND, INVALID, INTERNAL_ERROR, BLANK

📥RequestedOrderEditDeclineInput➕ AddedINPUT_OBJECT

The input fields for declining a requested edit.

🏗️RequestedOrderEditDeclinePayload➕ AddedOBJECT

Return type for requestedOrderEditDecline mutation.

Fields: requestedOrderEdit, userErrors

🏗️RequestedOrderEditDeclineUserError➕ AddedOBJECT

Errors related to declining a requested edit.

Fields: code, field, message

📋RequestedOrderEditDeclineUserErrorCode➕ AddedENUM

Possible error codes that can be returned by RequestedOrderEditDeclineUserError.

Values: NOT_FOUND, INVALID

🏗️RequestedOrderEditEdge➕ AddedOBJECT

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

Fields: cursor, node

🏗️RequestedOrderEditFinancialSummary➕ AddedOBJECT

The financial breakdown of the edit.

Fields: editOrderLevelDiscountSubtotalSet, editSubtotalBeforeTargetAllDiscountsSet, editSubtotalSet, editSubtotalWithCartDiscountSet, editTotalSet ... +1 more

🏗️RequestedOrderEditLineItem➕ AddedOBJECT

A line item included in a buyer-initiated requested edit.

Fields: id, lineItem, quantity, resolvedQuantity

🏗️RequestedOrderEditLineItemConnection➕ AddedOBJECT

An auto-generated type for paginating through multiple RequestedOrderEditLineItems.

Fields: edges, nodes, pageInfo

🏗️RequestedOrderEditLineItemEdge➕ AddedOBJECT

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

Fields: cursor, node

📥RequestedOrderEditLineItemRemovalInput➕ AddedINPUT_OBJECT

The input fields for a line item requested for removal in a requested edit.

🏗️RequestedOrderEditLineItems➕ AddedOBJECT

The line item changes on a requested edit, grouped by the type of change.

Fields: removals

📥RequestedOrderEditLineItemsInput➕ AddedINPUT_OBJECT

The input fields for the line item changes in a requested edit, grouped by the type of change.

📥RequestedOrderEditResolveInput➕ AddedINPUT_OBJECT

The input fields for resolving a requested edit.

🏗️RequestedOrderEditResolvePayload➕ AddedOBJECT

Return type for requestedOrderEditResolve mutation.

Fields: requestedOrderEdit, userErrors

🏗️RequestedOrderEditResolveUserError➕ AddedOBJECT

Errors related to resolving a requested edit.

Fields: code, field, message

📋RequestedOrderEditResolveUserErrorCode➕ AddedENUM

Possible error codes that can be returned by RequestedOrderEditResolveUserError.

Values: NOT_FOUND, INVALID

📋RequestedOrderEditStatus➕ AddedENUM

The status of a buyer-initiated requested edit.

Values: REQUESTED, RESOLVED, DENIED

➖ Removed Types (32)

📥CalculateRequestedEditInput➖ RemovedINPUT_OBJECT

The input fields to calculate the financial outcome of a requested order edit.

📥CalculateRequestedEditLineItemRemovalInput➖ RemovedINPUT_OBJECT

The input fields for a line item removal on a calculated edit.

📥CalculateRequestedEditLineItemsInput➖ RemovedINPUT_OBJECT

The input fields for the line item changes in an edit calculation, grouped by the type of change.

🏗️CalculatedRequestedEdit➖ RemovedOBJECT

The calculated financial outcome of an edit based on the line items requested for editing.

Fields: financialSummary, lineItems

🏗️CalculatedRequestedEditLineItem➖ RemovedOBJECT

The line item being processed for an edit and its calculated monetary values.

Fields: lineItem, quantity, subtotalSet, totalTaxSet

🏗️CalculatedRequestedEditLineItemConnection➖ RemovedOBJECT

An auto-generated type for paginating through multiple CalculatedRequestedEditLineItems.

Fields: edges, nodes, pageInfo

🏗️CalculatedRequestedEditLineItemEdge➖ RemovedOBJECT

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

Fields: cursor, node

🏗️CalculatedRequestedEditLineItems➖ RemovedOBJECT

The line item changes on a calculated edit, grouped by the type of change.

Fields: removals

📋OrderRequestedEditStatus➖ RemovedENUM

The order's aggregated requested edit status that's used for display purposes.
An order might have multiple requested edits, so this field communicates the prioritized status.
The OrderRequestedEditStatus enum is a supported filter parameter in the orders query.

Values: NONE, REQUESTED, RESOLVED, DENIED

🏗️RequestedEdit➖ RemovedOBJECT

A buyer-initiated request to edit unfulfilled line items on an order.

Fields: createdAt, id, lineItems, order, requestApprovedAt ... +4 more

🏗️RequestedEditConnection➖ RemovedOBJECT

An auto-generated type for paginating through multiple RequestedEdits.

Fields: edges, nodes, pageInfo

📥RequestedEditCreateInput➖ RemovedINPUT_OBJECT

The input fields for creating a requested edit.

🏗️RequestedEditCreatePayload➖ RemovedOBJECT

Return type for requestedEditCreate mutation.

Fields: requestedEdit, userErrors

🏗️RequestedEditCreateUserError➖ RemovedOBJECT

Errors related to creating a requested edit.

Fields: code, field, message

📋RequestedEditCreateUserErrorCode➖ RemovedENUM

Possible error codes that can be returned by RequestedEditCreateUserError.

Values: NOT_FOUND, INVALID, INTERNAL_ERROR, BLANK

📥RequestedEditDeclineInput➖ RemovedINPUT_OBJECT

The input fields for declining a requested edit.

🏗️RequestedEditDeclinePayload➖ RemovedOBJECT

Return type for requestedEditDecline mutation.

Fields: requestedEdit, userErrors

🏗️RequestedEditDeclineUserError➖ RemovedOBJECT

Errors related to declining a requested edit.

Fields: code, field, message

📋RequestedEditDeclineUserErrorCode➖ RemovedENUM

Possible error codes that can be returned by RequestedEditDeclineUserError.

Values: NOT_FOUND, INVALID

🏗️RequestedEditEdge➖ RemovedOBJECT

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

Fields: cursor, node

🏗️RequestedEditFinancialSummary➖ RemovedOBJECT

The financial breakdown of the edit.

Fields: editOrderLevelDiscountSubtotalSet, editSubtotalBeforeTargetAllDiscountsSet, editSubtotalSet, editSubtotalWithCartDiscountSet, editTotalSet ... +1 more

🏗️RequestedEditLineItem➖ RemovedOBJECT

A line item included in a buyer-initiated requested edit.

Fields: id, lineItem, quantity, resolvedQuantity

🏗️RequestedEditLineItemConnection➖ RemovedOBJECT

An auto-generated type for paginating through multiple RequestedEditLineItems.

Fields: edges, nodes, pageInfo

🏗️RequestedEditLineItemEdge➖ RemovedOBJECT

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

Fields: cursor, node

📥RequestedEditLineItemRemovalInput➖ RemovedINPUT_OBJECT

The input fields for a line item requested for removal in a requested edit.

🏗️RequestedEditLineItems➖ RemovedOBJECT

The line item changes on a requested edit, grouped by the type of change.

Fields: removals

📥RequestedEditLineItemsInput➖ RemovedINPUT_OBJECT

The input fields for the line item changes in a requested edit, grouped by the type of change.

📥RequestedEditResolveInput➖ RemovedINPUT_OBJECT

The input fields for resolving a requested edit.

🏗️RequestedEditResolvePayload➖ RemovedOBJECT

Return type for requestedEditResolve mutation.

Fields: requestedEdit, userErrors

🏗️RequestedEditResolveUserError➖ RemovedOBJECT

Errors related to resolving a requested edit.

Fields: code, field, message

📋RequestedEditResolveUserErrorCode➖ RemovedENUM

Possible error codes that can be returned by RequestedEditResolveUserError.

Values: NOT_FOUND, INVALID

📋RequestedEditStatus➖ RemovedENUM

The status of a buyer-initiated requested edit.

Values: REQUESTED, RESOLVED, DENIED

🔄 Modified Types (10)

🏗️Company🔄 Modified

🔄 Field modified: orders

Before:

📝

The list of the company's orders.

Type: OrderConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: OrderSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	acceptable_values	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.		- `query=Bob Norman` - `query=title:green hoodie`
cart_token	string	Filter by the cart token's unique value to track abandoned cart conversions or troubleshoot checkout issues. The token references the cart that's associated with an order.		- `cart_token:abc123`
channel	string	Filter by the order attribution `handle` (`Order.attribution.handle`) field. The legacy channel information `handle` (`ChannelInformation.channelDefinition.handle`) field is deprecated but remains supported during the deprecation period.		- `channel:web` - `channel:web,pos`
channel_id	id	Filter by the channel `id` field.		- `channel_id:123`
chargeback_status	string	Filter by the order's chargeback status. A chargeback occurs when a customer questions the legitimacy of a charge with their financial institution.	- `accepted` - `charge_refunded` - `lost` - `needs_response` - `under_review` - `won`	- `chargeback_status:accepted`
checkout_token	string	Filter by the checkout token's unique value to analyze conversion funnels or resolve payment issues. The checkout token's value references the checkout that's associated with an order.		- `checkout_token:abc123`
confirmation_number	string	Filter by the randomly generated alpha-numeric identifier for an order that can be displayed to the customer instead of the sequential order name. This value isn't guaranteed to be unique.		- `confirmation_number:ABC123`
created_at	time	Filter by the date and time when the order was created in Shopify's system.		- `created_at:'2020-10-21T23:39:20Z'` - `created_at:<now` - `created_at:<=2024`
credit_card_last4	string	Filter by the last four digits of the payment card that was used to pay for the order. This filter matches only the last four digits of the card for heightened security.		- `credit_card_last4:1234`
current_total_price	float	Filter by the current total price of the order in the shop currency, including any returns/refunds/removals. This filter supports both exact values and ranges.		- `current_total_price:10` - `current_total_price:>=5.00 current_total_price:<=20.99`
customer_id	id	Filter orders by the customer `id` field.		- `customer_id:123`
delivery_method	string	Filter by the delivery `methodType` field.	- `shipping` - `pick-up` - `retail` - `local` - `pickup-point` - `none`	- `delivery_method:shipping`
discount_code	string	Filter by the case-insensitive discount code that was applied to the order at checkout. Limited to the first discount code used on an order. Maximum characters: 255.		- `discount_code:ABC123`
email	string	Filter by the email address that's associated with the order to provide customer support or analyze purchasing patterns.		- `email:example@shopify.com`
financial_status	string	Filter by the order `displayFinancialStatus` field.	- `paid` - `pending` - `authorized` - `partially_paid` - `partially_refunded` - `refunded` - `voided` - `expired`	- `financial_status:authorized`
fraud_protection_level	string	Filter by the level of fraud protection that's applied to the order. Use this filter to manage risk or handle disputes.	- `fully_protected` - `partially_protected` - `not_protected` - `pending` - `not_eligible` - `not_available`	- `fraud_protection_level:fully_protected`
fulfillment_location_id	id	Filter by the fulfillment location `id` (`Fulfillment.location.id`) field.		- `fulfillment_location_id:123`
fulfillment_status	string	Filter by the `displayFulfillmentStatus` field to prioritize shipments or monitor order processing.	- `unshipped` - `shipped` - `fulfilled` - `partial` - `scheduled` - `on_hold` - `unfulfilled` - `request_declined`	- `fulfillment_status:fulfilled`
gateway	string	Filter by the `paymentGatewayNames` field. Use this filter to find orders that were processed through specific payment providers like Shopify Payments, PayPal, or other custom payment gateways.		- `gateway:shopify_payments`
id	id	Filter by `id` range.		- `id:1234` - `id:>=1234` - `id:<=1234`
location_id	id	Filter by the location `id` that's associated with the order to view and manage orders for specific locations. For POS orders, locations must be defined in the Shopify admin under Settings > Locations. If no ID is provided, then the primary location of the shop is returned.		- `location_id:123`
metafields.{namespace}.{key}	mixed	Filters resources by metafield value. Format: `metafields.{namespace}.{key}:{value}`. Learn more about querying by metafield value.		- `metafields.custom.on_sale:true` - `metafields.product.material:"gid://shopify/Metaobject/43458085"`
name	string	Filter by the order `name` field.		- `name:1001-A`
payment_id	string	Filter by the payment ID that's associated with the order to reconcile financial records or troubleshoot payment issues.		- `payment_id:abc123`
payment_provider_id	id	Filter by the ID of the payment provider that's associated with the order to manage payment methods or troubleshoot transactions.		- `payment_provider_id:123`
po_number	string	Filter by the order `poNumber` field.		- `po_number:P01001`
processed_at	time	Filter by the order `processedAt` field.		- `processed_at:'2021-01-01T00:00:00Z'`
reference_location_id	id	Filter by the ID of a location that's associated with the order, such as locations from fulfillments, refunds, or the shop's primary location.		- `reference_location_id:123`
requested_edit_status	string	Filter by the order's `requestedEditStatus` to track which orders have buyer-initiated requested edits pending merchant action.	- `none` - `requested` - `resolved` - `denied`	- `requested_edit_status:requested`
return_status	string	Filter by the order's `returnStatus` to monitor returns processing and track which orders have active returns.	- `return_requested` - `in_progress` - `inspection_complete` - `returned` - `return_failed` - `no_return`	- `return_status:in_progress`
risk_level	string	Filter by the order risk assessment `riskLevel` field.	- `high` - `medium` - `low` - `none` - `pending`	- `risk_level:high`
sales_channel	string	Filter by the sales channel where the order was made to analyze performance or manage fulfillment processes.		- `sales_channel: some_sales_channel`
shipping_address_validation_result_summary	string	Filter by the validation status of the shipping address. Learn more about validating addresses.	- `has_issues` - `no_issues` - `not_validated`	- `shipping_address_validation_result_summary:no_issues`
sku	string	Filter by the product variant `sku` field. Learn more about SKUs.		- `sku:ABC123`
source_identifier	string	Filter by the ID of the order placed on the originating platform, such as a unique POS or third-party identifier. This value doesn't correspond to the Shopify ID that's generated from a completed draft order.		- `source_identifier:1234-12-1000`
source_name	string	Filter by the platform where the order was placed to distinguish between web orders, POS sales, draft orders, or third-party channels. Use this filter to analyze sales performance across different ordering methods.		- `source_name:web` - `source_name:shopify_draft_order`
status	string	Filter by the order's status to manage workflows or analyze the order lifecycle.	- `open` - `closed` - `cancelled` - `not_closed`	- `status:open`
subtotal_line_items_quantity	string	Filter by the total number of items across all line items in an order. This filter supports both exact values and ranges, and is useful for identifying bulk orders or analyzing purchase volume patterns.		- `subtotal_line_items_quantity:10` - `subtotal_line_items_quantity:5..20`
tag	string	Filter objects by the `tag` field.		- `tag:my_tag`
tag_not	string	Filter by objects that don’t have the specified tag.		- `tag_not:my_tag`
test	boolean	Filter by test orders. Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled.		- `test:true`
total_weight	string	Filter by the order weight. This filter supports both exact values and ranges, and is to be used to filter orders by the total weight of all items (excluding packaging). It takes a unit of measurement as a suffix. It accepts the following units: g, kg, lb, oz.		- `total_weight:10.5kg` - `total_weight:>=5g total_weight:<=20g` - `total_weight:.5 lb`
updated_at	time	Filter by the date and time when the order was last updated in Shopify's system.		- `updated_at:'2020-10-21T23:39:20Z'` - `updated_at:<now` - `updated_at:<=2024`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

After:

📝

The list of the company's orders.

Type: OrderConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: OrderSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	acceptable_values	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.		- `query=Bob Norman` - `query=title:green hoodie`
cart_token	string	Filter by the cart token's unique value to track abandoned cart conversions or troubleshoot checkout issues. The token references the cart that's associated with an order.		- `cart_token:abc123`
channel	string	Filter by the order attribution `handle` (`Order.attribution.handle`) field. The legacy channel information `handle` (`ChannelInformation.channelDefinition.handle`) field is deprecated but remains supported during the deprecation period.		- `channel:web` - `channel:web,pos`
channel_id	id	Filter by the channel `id` field.		- `channel_id:123`
chargeback_status	string	Filter by the order's chargeback status. A chargeback occurs when a customer questions the legitimacy of a charge with their financial institution.	- `accepted` - `charge_refunded` - `lost` - `needs_response` - `under_review` - `won`	- `chargeback_status:accepted`
checkout_token	string	Filter by the checkout token's unique value to analyze conversion funnels or resolve payment issues. The checkout token's value references the checkout that's associated with an order.		- `checkout_token:abc123`
confirmation_number	string	Filter by the randomly generated alpha-numeric identifier for an order that can be displayed to the customer instead of the sequential order name. This value isn't guaranteed to be unique.		- `confirmation_number:ABC123`
created_at	time	Filter by the date and time when the order was created in Shopify's system.		- `created_at:'2020-10-21T23:39:20Z'` - `created_at:<now` - `created_at:<=2024`
credit_card_last4	string	Filter by the last four digits of the payment card that was used to pay for the order. This filter matches only the last four digits of the card for heightened security.		- `credit_card_last4:1234`
current_total_price	float	Filter by the current total price of the order in the shop currency, including any returns/refunds/removals. This filter supports both exact values and ranges.		- `current_total_price:10` - `current_total_price:>=5.00 current_total_price:<=20.99`
customer_id	id	Filter orders by the customer `id` field.		- `customer_id:123`
delivery_method	string	Filter by the delivery `methodType` field.	- `shipping` - `pick-up` - `retail` - `local` - `pickup-point` - `none`	- `delivery_method:shipping`
discount_code	string	Filter by the case-insensitive discount code that was applied to the order at checkout. Limited to the first discount code used on an order. Maximum characters: 255.		- `discount_code:ABC123`
email	string	Filter by the email address that's associated with the order to provide customer support or analyze purchasing patterns.		- `email:example@shopify.com`
financial_status	string	Filter by the order `displayFinancialStatus` field.	- `paid` - `pending` - `authorized` - `partially_paid` - `partially_refunded` - `refunded` - `voided` - `expired`	- `financial_status:authorized`
fraud_protection_level	string	Filter by the level of fraud protection that's applied to the order. Use this filter to manage risk or handle disputes.	- `fully_protected` - `partially_protected` - `not_protected` - `pending` - `not_eligible` - `not_available`	- `fraud_protection_level:fully_protected`
fulfillment_location_id	id	Filter by the fulfillment location `id` (`Fulfillment.location.id`) field.		- `fulfillment_location_id:123`
fulfillment_status	string	Filter by the `displayFulfillmentStatus` field to prioritize shipments or monitor order processing.	- `unshipped` - `shipped` - `fulfilled` - `partial` - `scheduled` - `on_hold` - `unfulfilled` - `request_declined`	- `fulfillment_status:fulfilled`
gateway	string	Filter by the `paymentGatewayNames` field. Use this filter to find orders that were processed through specific payment providers like Shopify Payments, PayPal, or other custom payment gateways.		- `gateway:shopify_payments`
id	id	Filter by `id` range.		- `id:1234` - `id:>=1234` - `id:<=1234`
location_id	id	Filter by the location `id` that's associated with the order to view and manage orders for specific locations. For POS orders, locations must be defined in the Shopify admin under Settings > Locations. If no ID is provided, then the primary location of the shop is returned.		- `location_id:123`
metafields.{namespace}.{key}	mixed	Filters resources by metafield value. Format: `metafields.{namespace}.{key}:{value}`. Learn more about querying by metafield value.		- `metafields.custom.on_sale:true` - `metafields.product.material:"gid://shopify/Metaobject/43458085"`
name	string	Filter by the order `name` field.		- `name:1001-A`
payment_id	string	Filter by the payment ID that's associated with the order to reconcile financial records or troubleshoot payment issues.		- `payment_id:abc123`
payment_provider_id	id	Filter by the ID of the payment provider that's associated with the order to manage payment methods or troubleshoot transactions.		- `payment_provider_id:123`
po_number	string	Filter by the order `poNumber` field.		- `po_number:P01001`
processed_at	time	Filter by the order `processedAt` field.		- `processed_at:'2021-01-01T00:00:00Z'`
reference_location_id	id	Filter by the ID of a location that's associated with the order, such as locations from fulfillments, refunds, or the shop's primary location.		- `reference_location_id:123`
requested_order_edit_status	string	Filter by the order's `displayRequestedEditStatus` to track which orders have buyer-initiated requested edits pending merchant action.	- `none` - `requested` - `resolved` - `denied`	- `requested_order_edit_status:requested`
return_status	string	Filter by the order's `returnStatus` to monitor returns processing and track which orders have active returns.	- `return_requested` - `in_progress` - `inspection_complete` - `returned` - `return_failed` - `no_return`	- `return_status:in_progress`
risk_level	string	Filter by the order risk assessment `riskLevel` field.	- `high` - `medium` - `low` - `none` - `pending`	- `risk_level:high`
sales_channel	string	Filter by the sales channel where the order was made to analyze performance or manage fulfillment processes.		- `sales_channel: some_sales_channel`
shipping_address_validation_result_summary	string	Filter by the validation status of the shipping address. Learn more about validating addresses.	- `has_issues` - `no_issues` - `not_validated`	- `shipping_address_validation_result_summary:no_issues`
sku	string	Filter by the product variant `sku` field. Learn more about SKUs.		- `sku:ABC123`
source_identifier	string	Filter by the ID of the order placed on the originating platform, such as a unique POS or third-party identifier. This value doesn't correspond to the Shopify ID that's generated from a completed draft order.		- `source_identifier:1234-12-1000`
source_name	string	Filter by the platform where the order was placed to distinguish between web orders, POS sales, draft orders, or third-party channels. Use this filter to analyze sales performance across different ordering methods.		- `source_name:web` - `source_name:shopify_draft_order`
status	string	Filter by the order's status to manage workflows or analyze the order lifecycle.	- `open` - `closed` - `cancelled` - `not_closed`	- `status:open`
subtotal_line_items_quantity	string	Filter by the total number of items across all line items in an order. This filter supports both exact values and ranges, and is useful for identifying bulk orders or analyzing purchase volume patterns.		- `subtotal_line_items_quantity:10` - `subtotal_line_items_quantity:5..20`
tag	string	Filter objects by the `tag` field.		- `tag:my_tag`
tag_not	string	Filter by objects that don’t have the specified tag.		- `tag_not:my_tag`
test	boolean	Filter by test orders. Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled.		- `test:true`
total_weight	string	Filter by the order weight. This filter supports both exact values and ranges, and is to be used to filter orders by the total weight of all items (excluding packaging). It takes a unit of measurement as a suffix. It accepts the following units: g, kg, lb, oz.		- `total_weight:10.5kg` - `total_weight:>=5g total_weight:<=20g` - `total_weight:.5 lb`
updated_at	time	Filter by the date and time when the order was last updated in Shopify's system.		- `updated_at:'2020-10-21T23:39:20Z'` - `updated_at:<now` - `updated_at:<=2024`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

🏗️Customer🔄 Modified

🔄 Field modified: orders

Before:

📝

A list of the customer's orders.

Type: OrderConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: OrderSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	acceptable_values	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.		- `query=Bob Norman` - `query=title:green hoodie`
cart_token	string	Filter by the cart token's unique value to track abandoned cart conversions or troubleshoot checkout issues. The token references the cart that's associated with an order.		- `cart_token:abc123`
channel	string	Filter by the order attribution `handle` (`Order.attribution.handle`) field. The legacy channel information `handle` (`ChannelInformation.channelDefinition.handle`) field is deprecated but remains supported during the deprecation period.		- `channel:web` - `channel:web,pos`
channel_id	id	Filter by the channel `id` field.		- `channel_id:123`
chargeback_status	string	Filter by the order's chargeback status. A chargeback occurs when a customer questions the legitimacy of a charge with their financial institution.	- `accepted` - `charge_refunded` - `lost` - `needs_response` - `under_review` - `won`	- `chargeback_status:accepted`
checkout_token	string	Filter by the checkout token's unique value to analyze conversion funnels or resolve payment issues. The checkout token's value references the checkout that's associated with an order.		- `checkout_token:abc123`
confirmation_number	string	Filter by the randomly generated alpha-numeric identifier for an order that can be displayed to the customer instead of the sequential order name. This value isn't guaranteed to be unique.		- `confirmation_number:ABC123`
created_at	time	Filter by the date and time when the order was created in Shopify's system.		- `created_at:'2020-10-21T23:39:20Z'` - `created_at:<now` - `created_at:<=2024`
credit_card_last4	string	Filter by the last four digits of the payment card that was used to pay for the order. This filter matches only the last four digits of the card for heightened security.		- `credit_card_last4:1234`
current_total_price	float	Filter by the current total price of the order in the shop currency, including any returns/refunds/removals. This filter supports both exact values and ranges.		- `current_total_price:10` - `current_total_price:>=5.00 current_total_price:<=20.99`
customer_id	id	Filter orders by the customer `id` field.		- `customer_id:123`
delivery_method	string	Filter by the delivery `methodType` field.	- `shipping` - `pick-up` - `retail` - `local` - `pickup-point` - `none`	- `delivery_method:shipping`
discount_code	string	Filter by the case-insensitive discount code that was applied to the order at checkout. Limited to the first discount code used on an order. Maximum characters: 255.		- `discount_code:ABC123`
email	string	Filter by the email address that's associated with the order to provide customer support or analyze purchasing patterns.		- `email:example@shopify.com`
financial_status	string	Filter by the order `displayFinancialStatus` field.	- `paid` - `pending` - `authorized` - `partially_paid` - `partially_refunded` - `refunded` - `voided` - `expired`	- `financial_status:authorized`
fraud_protection_level	string	Filter by the level of fraud protection that's applied to the order. Use this filter to manage risk or handle disputes.	- `fully_protected` - `partially_protected` - `not_protected` - `pending` - `not_eligible` - `not_available`	- `fraud_protection_level:fully_protected`
fulfillment_location_id	id	Filter by the fulfillment location `id` (`Fulfillment.location.id`) field.		- `fulfillment_location_id:123`
fulfillment_status	string	Filter by the `displayFulfillmentStatus` field to prioritize shipments or monitor order processing.	- `unshipped` - `shipped` - `fulfilled` - `partial` - `scheduled` - `on_hold` - `unfulfilled` - `request_declined`	- `fulfillment_status:fulfilled`
gateway	string	Filter by the `paymentGatewayNames` field. Use this filter to find orders that were processed through specific payment providers like Shopify Payments, PayPal, or other custom payment gateways.		- `gateway:shopify_payments`
id	id	Filter by `id` range.		- `id:1234` - `id:>=1234` - `id:<=1234`
location_id	id	Filter by the location `id` that's associated with the order to view and manage orders for specific locations. For POS orders, locations must be defined in the Shopify admin under Settings > Locations. If no ID is provided, then the primary location of the shop is returned.		- `location_id:123`
metafields.{namespace}.{key}	mixed	Filters resources by metafield value. Format: `metafields.{namespace}.{key}:{value}`. Learn more about querying by metafield value.		- `metafields.custom.on_sale:true` - `metafields.product.material:"gid://shopify/Metaobject/43458085"`
name	string	Filter by the order `name` field.		- `name:1001-A`
payment_id	string	Filter by the payment ID that's associated with the order to reconcile financial records or troubleshoot payment issues.		- `payment_id:abc123`
payment_provider_id	id	Filter by the ID of the payment provider that's associated with the order to manage payment methods or troubleshoot transactions.		- `payment_provider_id:123`
po_number	string	Filter by the order `poNumber` field.		- `po_number:P01001`
processed_at	time	Filter by the order `processedAt` field.		- `processed_at:'2021-01-01T00:00:00Z'`
reference_location_id	id	Filter by the ID of a location that's associated with the order, such as locations from fulfillments, refunds, or the shop's primary location.		- `reference_location_id:123`
requested_edit_status	string	Filter by the order's `requestedEditStatus` to track which orders have buyer-initiated requested edits pending merchant action.	- `none` - `requested` - `resolved` - `denied`	- `requested_edit_status:requested`
return_status	string	Filter by the order's `returnStatus` to monitor returns processing and track which orders have active returns.	- `return_requested` - `in_progress` - `inspection_complete` - `returned` - `return_failed` - `no_return`	- `return_status:in_progress`
risk_level	string	Filter by the order risk assessment `riskLevel` field.	- `high` - `medium` - `low` - `none` - `pending`	- `risk_level:high`
sales_channel	string	Filter by the sales channel where the order was made to analyze performance or manage fulfillment processes.		- `sales_channel: some_sales_channel`
shipping_address_validation_result_summary	string	Filter by the validation status of the shipping address. Learn more about validating addresses.	- `has_issues` - `no_issues` - `not_validated`	- `shipping_address_validation_result_summary:no_issues`
sku	string	Filter by the product variant `sku` field. Learn more about SKUs.		- `sku:ABC123`
source_identifier	string	Filter by the ID of the order placed on the originating platform, such as a unique POS or third-party identifier. This value doesn't correspond to the Shopify ID that's generated from a completed draft order.		- `source_identifier:1234-12-1000`
source_name	string	Filter by the platform where the order was placed to distinguish between web orders, POS sales, draft orders, or third-party channels. Use this filter to analyze sales performance across different ordering methods.		- `source_name:web` - `source_name:shopify_draft_order`
status	string	Filter by the order's status to manage workflows or analyze the order lifecycle.	- `open` - `closed` - `cancelled` - `not_closed`	- `status:open`
subtotal_line_items_quantity	string	Filter by the total number of items across all line items in an order. This filter supports both exact values and ranges, and is useful for identifying bulk orders or analyzing purchase volume patterns.		- `subtotal_line_items_quantity:10` - `subtotal_line_items_quantity:5..20`
tag	string	Filter objects by the `tag` field.		- `tag:my_tag`
tag_not	string	Filter by objects that don’t have the specified tag.		- `tag_not:my_tag`
test	boolean	Filter by test orders. Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled.		- `test:true`
total_weight	string	Filter by the order weight. This filter supports both exact values and ranges, and is to be used to filter orders by the total weight of all items (excluding packaging). It takes a unit of measurement as a suffix. It accepts the following units: g, kg, lb, oz.		- `total_weight:10.5kg` - `total_weight:>=5g total_weight:<=20g` - `total_weight:.5 lb`
updated_at	time	Filter by the date and time when the order was last updated in Shopify's system.		- `updated_at:'2020-10-21T23:39:20Z'` - `updated_at:<now` - `updated_at:<=2024`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

After:

📝

A list of the customer's orders.

Type: OrderConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: OrderSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	acceptable_values	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.		- `query=Bob Norman` - `query=title:green hoodie`
cart_token	string	Filter by the cart token's unique value to track abandoned cart conversions or troubleshoot checkout issues. The token references the cart that's associated with an order.		- `cart_token:abc123`
channel	string	Filter by the order attribution `handle` (`Order.attribution.handle`) field. The legacy channel information `handle` (`ChannelInformation.channelDefinition.handle`) field is deprecated but remains supported during the deprecation period.		- `channel:web` - `channel:web,pos`
channel_id	id	Filter by the channel `id` field.		- `channel_id:123`
chargeback_status	string	Filter by the order's chargeback status. A chargeback occurs when a customer questions the legitimacy of a charge with their financial institution.	- `accepted` - `charge_refunded` - `lost` - `needs_response` - `under_review` - `won`	- `chargeback_status:accepted`
checkout_token	string	Filter by the checkout token's unique value to analyze conversion funnels or resolve payment issues. The checkout token's value references the checkout that's associated with an order.		- `checkout_token:abc123`
confirmation_number	string	Filter by the randomly generated alpha-numeric identifier for an order that can be displayed to the customer instead of the sequential order name. This value isn't guaranteed to be unique.		- `confirmation_number:ABC123`
created_at	time	Filter by the date and time when the order was created in Shopify's system.		- `created_at:'2020-10-21T23:39:20Z'` - `created_at:<now` - `created_at:<=2024`
credit_card_last4	string	Filter by the last four digits of the payment card that was used to pay for the order. This filter matches only the last four digits of the card for heightened security.		- `credit_card_last4:1234`
current_total_price	float	Filter by the current total price of the order in the shop currency, including any returns/refunds/removals. This filter supports both exact values and ranges.		- `current_total_price:10` - `current_total_price:>=5.00 current_total_price:<=20.99`
customer_id	id	Filter orders by the customer `id` field.		- `customer_id:123`
delivery_method	string	Filter by the delivery `methodType` field.	- `shipping` - `pick-up` - `retail` - `local` - `pickup-point` - `none`	- `delivery_method:shipping`
discount_code	string	Filter by the case-insensitive discount code that was applied to the order at checkout. Limited to the first discount code used on an order. Maximum characters: 255.		- `discount_code:ABC123`
email	string	Filter by the email address that's associated with the order to provide customer support or analyze purchasing patterns.		- `email:example@shopify.com`
financial_status	string	Filter by the order `displayFinancialStatus` field.	- `paid` - `pending` - `authorized` - `partially_paid` - `partially_refunded` - `refunded` - `voided` - `expired`	- `financial_status:authorized`
fraud_protection_level	string	Filter by the level of fraud protection that's applied to the order. Use this filter to manage risk or handle disputes.	- `fully_protected` - `partially_protected` - `not_protected` - `pending` - `not_eligible` - `not_available`	- `fraud_protection_level:fully_protected`
fulfillment_location_id	id	Filter by the fulfillment location `id` (`Fulfillment.location.id`) field.		- `fulfillment_location_id:123`
fulfillment_status	string	Filter by the `displayFulfillmentStatus` field to prioritize shipments or monitor order processing.	- `unshipped` - `shipped` - `fulfilled` - `partial` - `scheduled` - `on_hold` - `unfulfilled` - `request_declined`	- `fulfillment_status:fulfilled`
gateway	string	Filter by the `paymentGatewayNames` field. Use this filter to find orders that were processed through specific payment providers like Shopify Payments, PayPal, or other custom payment gateways.		- `gateway:shopify_payments`
id	id	Filter by `id` range.		- `id:1234` - `id:>=1234` - `id:<=1234`
location_id	id	Filter by the location `id` that's associated with the order to view and manage orders for specific locations. For POS orders, locations must be defined in the Shopify admin under Settings > Locations. If no ID is provided, then the primary location of the shop is returned.		- `location_id:123`
metafields.{namespace}.{key}	mixed	Filters resources by metafield value. Format: `metafields.{namespace}.{key}:{value}`. Learn more about querying by metafield value.		- `metafields.custom.on_sale:true` - `metafields.product.material:"gid://shopify/Metaobject/43458085"`
name	string	Filter by the order `name` field.		- `name:1001-A`
payment_id	string	Filter by the payment ID that's associated with the order to reconcile financial records or troubleshoot payment issues.		- `payment_id:abc123`
payment_provider_id	id	Filter by the ID of the payment provider that's associated with the order to manage payment methods or troubleshoot transactions.		- `payment_provider_id:123`
po_number	string	Filter by the order `poNumber` field.		- `po_number:P01001`
processed_at	time	Filter by the order `processedAt` field.		- `processed_at:'2021-01-01T00:00:00Z'`
reference_location_id	id	Filter by the ID of a location that's associated with the order, such as locations from fulfillments, refunds, or the shop's primary location.		- `reference_location_id:123`
requested_order_edit_status	string	Filter by the order's `displayRequestedEditStatus` to track which orders have buyer-initiated requested edits pending merchant action.	- `none` - `requested` - `resolved` - `denied`	- `requested_order_edit_status:requested`
return_status	string	Filter by the order's `returnStatus` to monitor returns processing and track which orders have active returns.	- `return_requested` - `in_progress` - `inspection_complete` - `returned` - `return_failed` - `no_return`	- `return_status:in_progress`
risk_level	string	Filter by the order risk assessment `riskLevel` field.	- `high` - `medium` - `low` - `none` - `pending`	- `risk_level:high`
sales_channel	string	Filter by the sales channel where the order was made to analyze performance or manage fulfillment processes.		- `sales_channel: some_sales_channel`
shipping_address_validation_result_summary	string	Filter by the validation status of the shipping address. Learn more about validating addresses.	- `has_issues` - `no_issues` - `not_validated`	- `shipping_address_validation_result_summary:no_issues`
sku	string	Filter by the product variant `sku` field. Learn more about SKUs.		- `sku:ABC123`
source_identifier	string	Filter by the ID of the order placed on the originating platform, such as a unique POS or third-party identifier. This value doesn't correspond to the Shopify ID that's generated from a completed draft order.		- `source_identifier:1234-12-1000`
source_name	string	Filter by the platform where the order was placed to distinguish between web orders, POS sales, draft orders, or third-party channels. Use this filter to analyze sales performance across different ordering methods.		- `source_name:web` - `source_name:shopify_draft_order`
status	string	Filter by the order's status to manage workflows or analyze the order lifecycle.	- `open` - `closed` - `cancelled` - `not_closed`	- `status:open`
subtotal_line_items_quantity	string	Filter by the total number of items across all line items in an order. This filter supports both exact values and ranges, and is useful for identifying bulk orders or analyzing purchase volume patterns.		- `subtotal_line_items_quantity:10` - `subtotal_line_items_quantity:5..20`
tag	string	Filter objects by the `tag` field.		- `tag:my_tag`
tag_not	string	Filter by objects that don’t have the specified tag.		- `tag_not:my_tag`
test	boolean	Filter by test orders. Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled.		- `test:true`
total_weight	string	Filter by the order weight. This filter supports both exact values and ranges, and is to be used to filter orders by the total weight of all items (excluding packaging). It takes a unit of measurement as a suffix. It accepts the following units: g, kg, lb, oz.		- `total_weight:10.5kg` - `total_weight:>=5g total_weight:<=20g` - `total_weight:.5 lb`
updated_at	time	Filter by the date and time when the order was last updated in Shopify's system.		- `updated_at:'2020-10-21T23:39:20Z'` - `updated_at:<now` - `updated_at:<=2024`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

🏗️GiftCardProductSetUserErrorCode🔄 Modified

➕ Enum value added: INCOMPATIBLE_BARCODE_FIELDS

➕ Enum value added: BLANK_BARCODE_VALUE

➕ Enum value added: TOO_MANY_BARCODES

➕ Enum value added: BARCODE_VALUE_TOO_LONG

➕ Enum value added: DUPLICATE_BARCODE_VALUE

➕ Enum value added: INVALID_BARCODE_TYPE

➕ Enum value added: INVALID_BARCODE_SEPARATORS

➕ Enum value added: INVALID_BARCODE_LENGTH

➕ Enum value added: INVALID_BARCODE_PREFIX

➕ Enum value added: INVALID_BARCODE_CHARACTERS

➕ Enum value added: BARCODE_CHECKSUM_VALIDATION_FAILED

🏗️Order🔄 Modified

➖ Field removed: requestedEditStatus

➖ Field removed: requestedEdits

➕ Field added: displayRequestedEditStatus

The order's aggregated requested edit status for display purposes.
Indicates the overall state of buyer-initiated requested edits for the order,
helping merchants track and manage pending requests.

➕ Field added: requestedOrderEdits

The buyer-initiated requested edits on unfulfilled line items for this order.

🏗️ProductSetUserErrorCode🔄 Modified

➕ Enum value added: INCOMPATIBLE_BARCODE_FIELDS

➕ Enum value added: BLANK_BARCODE_VALUE

➕ Enum value added: TOO_MANY_BARCODES

➕ Enum value added: BARCODE_VALUE_TOO_LONG

➕ Enum value added: DUPLICATE_BARCODE_VALUE

➕ Enum value added: INVALID_BARCODE_TYPE

➕ Enum value added: INVALID_BARCODE_SEPARATORS

➕ Enum value added: INVALID_BARCODE_LENGTH

➕ Enum value added: INVALID_BARCODE_PREFIX

➕ Enum value added: INVALID_BARCODE_CHARACTERS

➕ Enum value added: BARCODE_CHECKSUM_VALIDATION_FAILED

🏗️ProductVariant🔄 Modified

➕ Field added: barcodes

The barcodes associated with the product variant.

A variant supports up to 20 barcodes, each of
which can have a
type.
Barcode types are validated against their respective format standards.

🏗️ProductVariantsBulkCreateUserErrorCode🔄 Modified

➕ Enum value added: INCOMPATIBLE_BARCODE_FIELDS

➕ Enum value added: BLANK_BARCODE_VALUE

➕ Enum value added: TOO_MANY_BARCODES

➕ Enum value added: BARCODE_VALUE_TOO_LONG

➕ Enum value added: DUPLICATE_BARCODE_VALUE

➕ Enum value added: INVALID_BARCODE_TYPE

➕ Enum value added: INVALID_BARCODE_SEPARATORS

➕ Enum value added: INVALID_BARCODE_LENGTH

➕ Enum value added: INVALID_BARCODE_PREFIX

➕ Enum value added: INVALID_BARCODE_CHARACTERS

➕ Enum value added: BARCODE_CHECKSUM_VALIDATION_FAILED

🏗️ProductVariantsBulkUpdateUserErrorCode🔄 Modified

➕ Enum value added: INCOMPATIBLE_BARCODE_FIELDS

➕ Enum value added: BLANK_BARCODE_VALUE

➕ Enum value added: TOO_MANY_BARCODES

➕ Enum value added: BARCODE_VALUE_TOO_LONG

➕ Enum value added: DUPLICATE_BARCODE_VALUE

➕ Enum value added: INVALID_BARCODE_TYPE

➕ Enum value added: INVALID_BARCODE_SEPARATORS

➕ Enum value added: INVALID_BARCODE_LENGTH

➕ Enum value added: INVALID_BARCODE_PREFIX

➕ Enum value added: INVALID_BARCODE_CHARACTERS

➕ Enum value added: BARCODE_CHECKSUM_VALIDATION_FAILED

🏗️Shop🔄 Modified

🔄 Field modified: orders

Before:

📝

A list of the shop's orders.

Type: OrderConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: OrderSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	acceptable_values	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.		- `query=Bob Norman` - `query=title:green hoodie`
cart_token	string	Filter by the cart token's unique value to track abandoned cart conversions or troubleshoot checkout issues. The token references the cart that's associated with an order.		- `cart_token:abc123`
channel	string	Filter by the order attribution `handle` (`Order.attribution.handle`) field. The legacy channel information `handle` (`ChannelInformation.channelDefinition.handle`) field is deprecated but remains supported during the deprecation period.		- `channel:web` - `channel:web,pos`
channel_id	id	Filter by the channel `id` field.		- `channel_id:123`
chargeback_status	string	Filter by the order's chargeback status. A chargeback occurs when a customer questions the legitimacy of a charge with their financial institution.	- `accepted` - `charge_refunded` - `lost` - `needs_response` - `under_review` - `won`	- `chargeback_status:accepted`
checkout_token	string	Filter by the checkout token's unique value to analyze conversion funnels or resolve payment issues. The checkout token's value references the checkout that's associated with an order.		- `checkout_token:abc123`
confirmation_number	string	Filter by the randomly generated alpha-numeric identifier for an order that can be displayed to the customer instead of the sequential order name. This value isn't guaranteed to be unique.		- `confirmation_number:ABC123`
created_at	time	Filter by the date and time when the order was created in Shopify's system.		- `created_at:'2020-10-21T23:39:20Z'` - `created_at:<now` - `created_at:<=2024`
credit_card_last4	string	Filter by the last four digits of the payment card that was used to pay for the order. This filter matches only the last four digits of the card for heightened security.		- `credit_card_last4:1234`
current_total_price	float	Filter by the current total price of the order in the shop currency, including any returns/refunds/removals. This filter supports both exact values and ranges.		- `current_total_price:10` - `current_total_price:>=5.00 current_total_price:<=20.99`
customer_id	id	Filter orders by the customer `id` field.		- `customer_id:123`
delivery_method	string	Filter by the delivery `methodType` field.	- `shipping` - `pick-up` - `retail` - `local` - `pickup-point` - `none`	- `delivery_method:shipping`
discount_code	string	Filter by the case-insensitive discount code that was applied to the order at checkout. Limited to the first discount code used on an order. Maximum characters: 255.		- `discount_code:ABC123`
email	string	Filter by the email address that's associated with the order to provide customer support or analyze purchasing patterns.		- `email:example@shopify.com`
financial_status	string	Filter by the order `displayFinancialStatus` field.	- `paid` - `pending` - `authorized` - `partially_paid` - `partially_refunded` - `refunded` - `voided` - `expired`	- `financial_status:authorized`
fraud_protection_level	string	Filter by the level of fraud protection that's applied to the order. Use this filter to manage risk or handle disputes.	- `fully_protected` - `partially_protected` - `not_protected` - `pending` - `not_eligible` - `not_available`	- `fraud_protection_level:fully_protected`
fulfillment_location_id	id	Filter by the fulfillment location `id` (`Fulfillment.location.id`) field.		- `fulfillment_location_id:123`
fulfillment_status	string	Filter by the `displayFulfillmentStatus` field to prioritize shipments or monitor order processing.	- `unshipped` - `shipped` - `fulfilled` - `partial` - `scheduled` - `on_hold` - `unfulfilled` - `request_declined`	- `fulfillment_status:fulfilled`
gateway	string	Filter by the `paymentGatewayNames` field. Use this filter to find orders that were processed through specific payment providers like Shopify Payments, PayPal, or other custom payment gateways.		- `gateway:shopify_payments`
id	id	Filter by `id` range.		- `id:1234` - `id:>=1234` - `id:<=1234`
location_id	id	Filter by the location `id` that's associated with the order to view and manage orders for specific locations. For POS orders, locations must be defined in the Shopify admin under Settings > Locations. If no ID is provided, then the primary location of the shop is returned.		- `location_id:123`
metafields.{namespace}.{key}	mixed	Filters resources by metafield value. Format: `metafields.{namespace}.{key}:{value}`. Learn more about querying by metafield value.		- `metafields.custom.on_sale:true` - `metafields.product.material:"gid://shopify/Metaobject/43458085"`
name	string	Filter by the order `name` field.		- `name:1001-A`
payment_id	string	Filter by the payment ID that's associated with the order to reconcile financial records or troubleshoot payment issues.		- `payment_id:abc123`
payment_provider_id	id	Filter by the ID of the payment provider that's associated with the order to manage payment methods or troubleshoot transactions.		- `payment_provider_id:123`
po_number	string	Filter by the order `poNumber` field.		- `po_number:P01001`
processed_at	time	Filter by the order `processedAt` field.		- `processed_at:'2021-01-01T00:00:00Z'`
reference_location_id	id	Filter by the ID of a location that's associated with the order, such as locations from fulfillments, refunds, or the shop's primary location.		- `reference_location_id:123`
requested_edit_status	string	Filter by the order's `requestedEditStatus` to track which orders have buyer-initiated requested edits pending merchant action.	- `none` - `requested` - `resolved` - `denied`	- `requested_edit_status:requested`
return_status	string	Filter by the order's `returnStatus` to monitor returns processing and track which orders have active returns.	- `return_requested` - `in_progress` - `inspection_complete` - `returned` - `return_failed` - `no_return`	- `return_status:in_progress`
risk_level	string	Filter by the order risk assessment `riskLevel` field.	- `high` - `medium` - `low` - `none` - `pending`	- `risk_level:high`
sales_channel	string	Filter by the sales channel where the order was made to analyze performance or manage fulfillment processes.		- `sales_channel: some_sales_channel`
shipping_address_validation_result_summary	string	Filter by the validation status of the shipping address. Learn more about validating addresses.	- `has_issues` - `no_issues` - `not_validated`	- `shipping_address_validation_result_summary:no_issues`
sku	string	Filter by the product variant `sku` field. Learn more about SKUs.		- `sku:ABC123`
source_identifier	string	Filter by the ID of the order placed on the originating platform, such as a unique POS or third-party identifier. This value doesn't correspond to the Shopify ID that's generated from a completed draft order.		- `source_identifier:1234-12-1000`
source_name	string	Filter by the platform where the order was placed to distinguish between web orders, POS sales, draft orders, or third-party channels. Use this filter to analyze sales performance across different ordering methods.		- `source_name:web` - `source_name:shopify_draft_order`
status	string	Filter by the order's status to manage workflows or analyze the order lifecycle.	- `open` - `closed` - `cancelled` - `not_closed`	- `status:open`
subtotal_line_items_quantity	string	Filter by the total number of items across all line items in an order. This filter supports both exact values and ranges, and is useful for identifying bulk orders or analyzing purchase volume patterns.		- `subtotal_line_items_quantity:10` - `subtotal_line_items_quantity:5..20`
tag	string	Filter objects by the `tag` field.		- `tag:my_tag`
tag_not	string	Filter by objects that don’t have the specified tag.		- `tag_not:my_tag`
test	boolean	Filter by test orders. Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled.		- `test:true`
total_weight	string	Filter by the order weight. This filter supports both exact values and ranges, and is to be used to filter orders by the total weight of all items (excluding packaging). It takes a unit of measurement as a suffix. It accepts the following units: g, kg, lb, oz.		- `total_weight:10.5kg` - `total_weight:>=5g total_weight:<=20g` - `total_weight:.5 lb`
updated_at	time	Filter by the date and time when the order was last updated in Shopify's system.		- `updated_at:'2020-10-21T23:39:20Z'` - `updated_at:<now` - `updated_at:<=2024`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

⚠️ Deprecated: Use `QueryRoot.orders` instead.

After:

📝

A list of the shop's orders.

Type: OrderConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: OrderSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	acceptable_values	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.		- `query=Bob Norman` - `query=title:green hoodie`
cart_token	string	Filter by the cart token's unique value to track abandoned cart conversions or troubleshoot checkout issues. The token references the cart that's associated with an order.		- `cart_token:abc123`
channel	string	Filter by the order attribution `handle` (`Order.attribution.handle`) field. The legacy channel information `handle` (`ChannelInformation.channelDefinition.handle`) field is deprecated but remains supported during the deprecation period.		- `channel:web` - `channel:web,pos`
channel_id	id	Filter by the channel `id` field.		- `channel_id:123`
chargeback_status	string	Filter by the order's chargeback status. A chargeback occurs when a customer questions the legitimacy of a charge with their financial institution.	- `accepted` - `charge_refunded` - `lost` - `needs_response` - `under_review` - `won`	- `chargeback_status:accepted`
checkout_token	string	Filter by the checkout token's unique value to analyze conversion funnels or resolve payment issues. The checkout token's value references the checkout that's associated with an order.		- `checkout_token:abc123`
confirmation_number	string	Filter by the randomly generated alpha-numeric identifier for an order that can be displayed to the customer instead of the sequential order name. This value isn't guaranteed to be unique.		- `confirmation_number:ABC123`
created_at	time	Filter by the date and time when the order was created in Shopify's system.		- `created_at:'2020-10-21T23:39:20Z'` - `created_at:<now` - `created_at:<=2024`
credit_card_last4	string	Filter by the last four digits of the payment card that was used to pay for the order. This filter matches only the last four digits of the card for heightened security.		- `credit_card_last4:1234`
current_total_price	float	Filter by the current total price of the order in the shop currency, including any returns/refunds/removals. This filter supports both exact values and ranges.		- `current_total_price:10` - `current_total_price:>=5.00 current_total_price:<=20.99`
customer_id	id	Filter orders by the customer `id` field.		- `customer_id:123`
delivery_method	string	Filter by the delivery `methodType` field.	- `shipping` - `pick-up` - `retail` - `local` - `pickup-point` - `none`	- `delivery_method:shipping`
discount_code	string	Filter by the case-insensitive discount code that was applied to the order at checkout. Limited to the first discount code used on an order. Maximum characters: 255.		- `discount_code:ABC123`
email	string	Filter by the email address that's associated with the order to provide customer support or analyze purchasing patterns.		- `email:example@shopify.com`
financial_status	string	Filter by the order `displayFinancialStatus` field.	- `paid` - `pending` - `authorized` - `partially_paid` - `partially_refunded` - `refunded` - `voided` - `expired`	- `financial_status:authorized`
fraud_protection_level	string	Filter by the level of fraud protection that's applied to the order. Use this filter to manage risk or handle disputes.	- `fully_protected` - `partially_protected` - `not_protected` - `pending` - `not_eligible` - `not_available`	- `fraud_protection_level:fully_protected`
fulfillment_location_id	id	Filter by the fulfillment location `id` (`Fulfillment.location.id`) field.		- `fulfillment_location_id:123`
fulfillment_status	string	Filter by the `displayFulfillmentStatus` field to prioritize shipments or monitor order processing.	- `unshipped` - `shipped` - `fulfilled` - `partial` - `scheduled` - `on_hold` - `unfulfilled` - `request_declined`	- `fulfillment_status:fulfilled`
gateway	string	Filter by the `paymentGatewayNames` field. Use this filter to find orders that were processed through specific payment providers like Shopify Payments, PayPal, or other custom payment gateways.		- `gateway:shopify_payments`
id	id	Filter by `id` range.		- `id:1234` - `id:>=1234` - `id:<=1234`
location_id	id	Filter by the location `id` that's associated with the order to view and manage orders for specific locations. For POS orders, locations must be defined in the Shopify admin under Settings > Locations. If no ID is provided, then the primary location of the shop is returned.		- `location_id:123`
metafields.{namespace}.{key}	mixed	Filters resources by metafield value. Format: `metafields.{namespace}.{key}:{value}`. Learn more about querying by metafield value.		- `metafields.custom.on_sale:true` - `metafields.product.material:"gid://shopify/Metaobject/43458085"`
name	string	Filter by the order `name` field.		- `name:1001-A`
payment_id	string	Filter by the payment ID that's associated with the order to reconcile financial records or troubleshoot payment issues.		- `payment_id:abc123`
payment_provider_id	id	Filter by the ID of the payment provider that's associated with the order to manage payment methods or troubleshoot transactions.		- `payment_provider_id:123`
po_number	string	Filter by the order `poNumber` field.		- `po_number:P01001`
processed_at	time	Filter by the order `processedAt` field.		- `processed_at:'2021-01-01T00:00:00Z'`
reference_location_id	id	Filter by the ID of a location that's associated with the order, such as locations from fulfillments, refunds, or the shop's primary location.		- `reference_location_id:123`
requested_order_edit_status	string	Filter by the order's `displayRequestedEditStatus` to track which orders have buyer-initiated requested edits pending merchant action.	- `none` - `requested` - `resolved` - `denied`	- `requested_order_edit_status:requested`
return_status	string	Filter by the order's `returnStatus` to monitor returns processing and track which orders have active returns.	- `return_requested` - `in_progress` - `inspection_complete` - `returned` - `return_failed` - `no_return`	- `return_status:in_progress`
risk_level	string	Filter by the order risk assessment `riskLevel` field.	- `high` - `medium` - `low` - `none` - `pending`	- `risk_level:high`
sales_channel	string	Filter by the sales channel where the order was made to analyze performance or manage fulfillment processes.		- `sales_channel: some_sales_channel`
shipping_address_validation_result_summary	string	Filter by the validation status of the shipping address. Learn more about validating addresses.	- `has_issues` - `no_issues` - `not_validated`	- `shipping_address_validation_result_summary:no_issues`
sku	string	Filter by the product variant `sku` field. Learn more about SKUs.		- `sku:ABC123`
source_identifier	string	Filter by the ID of the order placed on the originating platform, such as a unique POS or third-party identifier. This value doesn't correspond to the Shopify ID that's generated from a completed draft order.		- `source_identifier:1234-12-1000`
source_name	string	Filter by the platform where the order was placed to distinguish between web orders, POS sales, draft orders, or third-party channels. Use this filter to analyze sales performance across different ordering methods.		- `source_name:web` - `source_name:shopify_draft_order`
status	string	Filter by the order's status to manage workflows or analyze the order lifecycle.	- `open` - `closed` - `cancelled` - `not_closed`	- `status:open`
subtotal_line_items_quantity	string	Filter by the total number of items across all line items in an order. This filter supports both exact values and ranges, and is useful for identifying bulk orders or analyzing purchase volume patterns.		- `subtotal_line_items_quantity:10` - `subtotal_line_items_quantity:5..20`
tag	string	Filter objects by the `tag` field.		- `tag:my_tag`
tag_not	string	Filter by objects that don’t have the specified tag.		- `tag_not:my_tag`
test	boolean	Filter by test orders. Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled.		- `test:true`
total_weight	string	Filter by the order weight. This filter supports both exact values and ranges, and is to be used to filter orders by the total weight of all items (excluding packaging). It takes a unit of measurement as a suffix. It accepts the following units: g, kg, lb, oz.		- `total_weight:10.5kg` - `total_weight:>=5g total_weight:<=20g` - `total_weight:.5 lb`
updated_at	time	Filter by the date and time when the order was last updated in Shopify's system.		- `updated_at:'2020-10-21T23:39:20Z'` - `updated_at:<now` - `updated_at:<=2024`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

⚠️ Deprecated: Use `QueryRoot.orders` instead.

🏗️WebhookSubscriptionTopic🔄 Modified

➖ Enum value removed: REQUESTED_EDITS_CREATE

➖ Enum value removed: REQUESTED_EDITS_RESOLVE

➖ Enum value removed: REQUESTED_EDITS_DENY

➕ Enum value added: REQUESTED_ORDER_EDIT_CREATED

➕ Enum value added: REQUESTED_ORDER_EDIT_RESOLVED

➕ Enum value added: REQUESTED_ORDER_EDIT_DENIED

Order Edit Calculation API, Filter Update, Subscription Draft Deprecation

Query Changes

➕ Added Queries (1)

➖ Removed Queries (1)

🔄 Modified Queries (3)

Mutation Changes

➕ Added Mutations (3)

➖ Removed Mutations (3)

🔄 Modified Mutations (13)

Type Changes

➕ Added Types (37)

➖ Removed Types (32)

🔄 Modified Types (10)

Field Modified: orders on Company

Before:

After:

Field Modified: orders on Customer

Before:

After:

Field Modified: orders on Shop

Before:

After:

Field Modified: `orders` on `Company`

Field Modified: `orders` on `Customer`

Field Modified: `orders` on `Shop`