Change: Add Channels Query, Revamp Descriptions, Update Filters

New allChannels query lists all active sales channels and supports pagination and reverse ordering. Description of appInstallation and appInstallations query now explicitly outlines usage for access scopes, subscriptions, billing, and installation state, including the availability of read_apps scope for custom and public apps. The automaticDiscount query continues to be deprecated but its description now clarifies that it returns a DiscountAutomatic union rather than an old generic resource. The customerSegmentMembersCount query now explains real‑time segment size calculations using provided criteria. Operators can now use more detailed filter syntax for customers, orders, and giftCards queries; giftCards’ default search now includes code matching; orders’ discount code filter now limits to the first code used. The mutation appRevokeAccessScopes has been rewritten to explain that it will remove specific permissions while keeping other app functionality and returns granular success or error information. WebhookSubscriptions’ description was expanded to detail the returned data, pagination, and how app‑scoped versus shop‑scoped subscriptions are distinguished.

Query Changes

➕ Added Queries (1)

allChannels

List of all the active sales channels on this shop.

🔄 Modified Queries (14)

appInstallation

Look up an app installation by ID or return the app installation for the currently authenticated app.

Use the appInstallation query to:

Fetch current access scope permissions for your app
Retrieve active subscription details and billing status
Validate installation state during app initialization
Display installation-specific information in your app interface

Learn more about app installation.

appInstallations

A list of app installations. To use this query, your app needs the read_apps access scope, which can only be requested after you're granted approval from Shopify Support. This scope can be granted to custom and public apps.

Returns a paginated connection of AppInstallation objects across multiple stores.

Learn more about app installation.

automaticDiscount

Returns a DiscountAutomatic resource by ID.

customerSegmentMembersCount

Returns the total number of customers who match the criteria defined in a customer segment. This count provides real-time visibility into segment size for targeting and analysis purposes.

For example, check the size of a "High-Value Customers" segment before launching a VIP program.

The count reflects current segment membership based on the segment's filter criteria, updating as customer data changes and new customers meet or no longer meet the segment conditions.

customers

Returns a list of customers in your Shopify store, including key information such as name, email, location, and purchase history.
Use this query to segment your audience, personalize marketing campaigns, or analyze customer behavior by applying filters based on location, order history, marketing preferences and tags.
The customers query supports pagination and sorting.

~ Modified argument: query

giftCards

Returns a list of gift cards.

~ Modified argument: query

giftCardsCount

The total number of gift cards issued for the shop. Limited to a maximum of 10000 by default.

~ Modified argument: query

orderEditSession

Returns a OrderEditSession resource by ID.

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 count of orders for the given shop. Limited to a maximum of 10000 by default.

~ Modified argument: query

returnableFulfillment

Returns a ReturnableFulfillment resource by ID.

subscriptionBillingAttempt

Returns a SubscriptionBillingAttempt resource by ID.

urlRedirectImport

Returns a UrlRedirectImport resource by ID.

webhookSubscriptions

Retrieves a paginated list of shop-scoped webhook subscriptions configured for the current app. This query returns webhook subscriptions created via the API for this shop, not including app-scoped subscriptions configured via TOML files.

For example, an app dashboard might use this query to display all configured webhooks, showing which events trigger notifications and their delivery endpoints for troubleshooting integration issues.

Use the webhookSubscriptions query to:

Audit all active shop-scoped webhook configurations
View and manage webhook subscription configurations
Display subscription details in app dashboards
Retrieve existing webhook configurations for dynamic integration setups
Check which subscriptions already exist before creating new ones

The query returns comprehensive subscription data including event topics, endpoint configurations, filtering rules, API versions, and metafield namespace permissions. Each subscription includes creation and modification timestamps for tracking configuration changes.

Results support standard GraphQL pagination patterns with cursor-based navigation, allowing efficient retrieval of large webhook subscription lists. The response includes detailed endpoint information varying by type - HTTP callback URLs, EventBridge ARNs, or Pub/Sub project and topic specifications.

Advanced subscription features like event filtering using Shopify search syntax, field inclusion rules, and metafield namespace access are fully exposed, providing complete visibility into webhook configuration.

Learn more about webhook subscription queries.

Building an app? If you only use app-specific webhooks, you won't need this. App-specific webhook subscriptions specified in your shopify.app.toml may be easier. They are automatically kept up to date by Shopify & require less maintenance. Please read About managing webhook subscriptions.

Mutation Changes

🔄 Modified Mutations (11)

appRevokeAccessScopes

Revokes previously granted access scopes from an app installation, allowing merchants to reduce an app's permissions without completely uninstalling it. This provides granular control over what data and functionality apps can access.

For example, if a merchant no longer wants an app to access customer information but still wants to use its inventory features, they can revoke the customer-related scopes while keeping inventory permissions active.

Use the appRevokeAccessScopes mutation to:

Remove specific permissions from installed apps
Maintain app functionality while minimizing data exposure

The mutation returns details about which scopes were successfully revoked and any errors that prevented certain permissions from being removed.

Learn more about managing app permissions.

appUninstall

Uninstalls an app from a shop.

This mutation can only be used by apps to uninstall themselves. Apps with the apps access scope can uninstall other apps by providing the app ID in the input parameter.

Use the appUninstall mutation to programmatically remove apps from shops.

The mutation returns the uninstalled app and any errors that occurred during the uninstallation process.

Learn more about app lifecycle management.

catalogCreate

Creates a new catalog. For a complete explanation of a Catalog's behaviour, and how you can use it with Publications and PriceLists, see here.

fulfillmentOrderOpen

Marks a scheduled fulfillment order as open.

From API version 2026-01, this will also mark a fulfillment order as open when it is assigned to a merchant managed location and has had progress reported.

fulfillmentServiceCreate

Creates a fulfillment service.

Fulfillment service location

When creating a fulfillment service, a new location will be automatically created on the shop
and will be associated with this fulfillment service.
This location will be named after the fulfillment service and inherit the shop's address.

If you are using API version 2023-10 or later, and you need to specify custom attributes for the fulfillment service location
(for example, to change its address to a country different from the shop's country),
use the
LocationEdit
mutation after creating the fulfillment service.

~ Modified argument: callbackUrl

~ Modified argument: trackingSupport

~ Modified argument: inventoryManagement

fulfillmentServiceUpdate

Updates a fulfillment service.

If you need to update the location managed by the fulfillment service (for example, to change the address of a fulfillment service), use the LocationEdit mutation.

~ Modified argument: callbackUrl

~ Modified argument: trackingSupport

~ Modified argument: inventoryManagement

productBundleCreate

Creates a new product bundle or componentized product.

~ Modified argument: input

productBundleUpdate

Updates a product bundle or componentized product.

~ Modified argument: input

webhookSubscriptionCreate

Set up webhook subscriptions so your app gets notified instantly when things happen in a merchant's store. Instead of constantly checking for changes, webhooks push updates to your app the moment they occur, making integrations faster and more efficient.

For example, an inventory management app might create subscriptions for orders/paid and inventory_levels/update events to automatically adjust stock levels and trigger fulfillment processes when customers complete purchases.

Use webhookSubscriptionCreate to:

Set up real-time event notifications for your app
Configure specific topics like order creation, product updates, or customer changes
Define endpoint destinations (HTTPS, EventBridge, or Pub/Sub)
Filter events using Shopify search syntax to receive notifications only for relevant events
Configure field inclusion to control which data fields are included in webhook payloads

The mutation supports multiple endpoint types and advanced filtering options, allowing you to create precisely targeted webhook subscriptions that match your app's integration needs. The API version is inherited from the app configuration and cannot be specified per subscription. Filters use Shopify search syntax to determine which events trigger notifications.

Successful creation returns the webhook subscription fields that you request in your query. The mutation validates topic availability, filter syntax, and endpoint configuration.

Learn more about creating webhook subscriptions.

webhookSubscriptionDelete

Removes an existing webhook subscription, stopping all future event notifications for that subscription. This mutation provides a clean way to deactivate webhooks when they're no longer needed.

For example, when an app feature is disabled or when you need to change webhook configurations, you can delete
the old webhook subscription to prevent unnecessary event delivery and potential errors. Alternatively, for
endpoint changes, you might consider updating the existing subscription instead of deleting and recreating it.

Use webhookSubscriptionDelete to:

Clean up unused webhook subscriptions
Stop event delivery to deprecated endpoints
Remove subscriptions during app uninstallation
Reduce unnecessary resource usage by removing unused subscriptions

The mutation returns the deleted subscription's ID for confirmation when successful. Validation errors are included in the response if you request them in your query, as with all GraphQL mutations.

Learn more about managing webhook subscriptions.

webhookSubscriptionUpdate

Updates an existing webhook subscription's configuration, allowing you to modify endpoints, topics, filters, and other subscription settings without recreating the entire subscription. This mutation provides flexible webhook management for evolving app requirements.

For example, when migrating from HTTP endpoints to EventBridge, you can update the subscription's endpoint configuration while preserving the same topic subscriptions and filters, ensuring continuity of event delivery during infrastructure changes.

Use webhookSubscriptionUpdate to:

Change webhook endpoint URLs or destination types
Modify event filtering criteria to refine event relevance
Adjust field inclusion settings to optimize payload sizes
Configure metafield namespace access for extended data

The mutation supports comprehensive configuration changes including endpoint type switching (HTTP to Pub/Sub, for instance), topic modifications, and advanced filtering updates. The API version is inherited from the app configuration and cannot be changed per subscription.

Updates are applied atomically, ensuring that webhook delivery continues uninterrupted during configuration changes. The response includes the updated subscription fields that you request in your query, and validation errors if requested.

Learn more about updating webhook configurations.

Type Changes

➕ Added Types (1)

🏗️ThirdPartyAppSubscriptionOverrideType➕ AddedOBJECT

Third-party app subscription overrides for a shop.

Fields: facebookInstagram, googleYoutube, instafeed, judgeMe, pagefly ... +1 more

🔄 Modified Types (23)

🏗️Channel🔄 Modified

🔄 Field modified: productsCount

Before:

📝

Retrieves the total count of products that are currently published to a specific sales channel. This provides a quick way to understand channel inventory without fetching the full product list.

For example, when building channel management dashboards, you can display how many products are available in each channel like "150 products in Online Store" or "75 products in Facebook Shop."

Use ChannelProductsCount to:

Display inventory summaries in channel management interfaces
Monitor product distribution across sales channels
Validate channel setup and product availability

The count reflects only published products and updates as merchants add or remove products from channels.

Learn more about sales channels. Limited to a maximum of 10000 by default.

Type: Count

Arguments:

query: String -

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

name	type	description	acceptable_values	default_value	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.			- `query=Bob Norman` - `query=title:green hoodie`
barcode	string	Filter by the product variant `barcode` field.			- `barcode:ABC-abc-1234`
bundles	boolean	Filter by a product bundle. A product bundle is a set of two or more related products, which are commonly offered at a discount.			- `bundles:true`
category_id	string	Filter by the product category ID (`product.category.id`). A product category is the category of a product from Shopify's Standard Product Taxonomy.			- `category_id:sg-4-17-2-17`
collection_id	id	Filter by the collection `id` field.			- `collection_id:108179161409`
combined_listing_role	string	Filter by the role of the product in a combined listing.	- `parent` - `child` - `no_role`		- `combined_listing_role:parent`
created_at	time	Filter by the date and time when the product was created.			- `created_at:>'2020-10-21T23:39:20Z'` - `created_at:<now` - `created_at:<='2024'`
delivery_profile_id	id	Filter by the delivery profile `id` field.			- `delivery_profile_id:108179161409`
error_feedback	string	Filter by products with publishing errors.
gift_card	boolean	Filter by the product `isGiftCard` field.			- `gift_card:true`
handle	string	Filter by a comma-separated list of product handles.			- `handle:the-minimal-snowboard`
has_only_composites	boolean	Filter by products that have only composite variants.			- `has_only_composites:true`
has_only_default_variant	boolean	Filter by products that have only a default variant. A default variant is the only variant if no other variants are specified.			- `has_only_default_variant:true`
has_variant_with_components	boolean	Filter by products that have variants with associated components.			- `has_variant_with_components:true`
id	id	Filter by `id` range.			- `id:1234` - `id:>=1234` - `id:<=1234`
inventory_total	integer	Filter by inventory count.			- `inventory_total:0` - `inventory_total:>150` - `inventory_total:>=200`
is_price_reduced	boolean	Filter by products that have a reduced price. For more information, refer to the `CollectionRule` object.			- `is_price_reduced:true`
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"`
out_of_stock_somewhere	boolean	Filter by products that are out of stock in at least one location.			- `out_of_stock_somewhere:true`
price	bigdecimal	Filter by the product variant `price` field.			- `price:100.57`
product_configuration_owner	string	Filter by the app `id` field.			- `product_configuration_owner:10001`
product_publication_status	string	Filter by the publication status of the resource on a channel, such as the online store. The value is a composite of the channel `app` ID (`Channel.app.id`) and one of the valid values.	- `approved` - `rejected` - `needs_action` - `awaiting_review` - `published` - `demoted` - `scheduled` - `provisionally_published`		- `product_publication_status:189769876-approved`
product_type	string	Filter by a comma-separated list of product types.			- `product_type:snowboard`
publication_ids	string	Filter by a comma-separated list of publication IDs that are associated with the product.			- `publication_ids:184111530305,184111694145`
publishable_status	string	Filter by the publishable status of the resource on a channel, such as the online store. The value is a composite of either the channel `app` ID (`Channel.app.id`) or channel `name` and one of the valid values.	- `online_store_channel` - `published` - `unpublished` - `visible` - `unavailable` - `hidden` - `intended` - `visible`		- `publishable_status:published` - `publishable_status:189769876-visible` - `publishable_status:pos-hidden`
published_at	time	Filter by the date and time when the product was published to the online store and other sales channels.			- `published_at:>2020-10-21T23:39:20Z` - `published_at:<now` - `published_at:<=2024`
published_status	string	Filter by the published status of the resource on a channel, such as the online store.	- `unset` - `pending` - `approved` - `not approved`		- `published_status:approved`
sku	string	Filter by the product variant `sku` field. Learn more about SKUs.			- `sku:XYZ-12345`
status	string	Filter by a comma-separated list of statuses. You can use statuses to manage inventory. Shopify only displays products with an `ACTIVE` status in online stores, sales channels, and apps.	- `active` - `archived` - `draft`	`active`	- `status:active,draft`
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`
title	string	Filter by the product `title` field.			- `title:The Minimal Snowboard`
updated_at	time	Filter by the date and time when the product was last updated.			- `updated_at:>'2020-10-21T23:39:20Z'` - `updated_at:<now` - `updated_at:<='2024'`
variant_id	id	Filter by the product variant `id` field.			- `variant_id:45779434701121`
variant_title	string	Filter by the product variant `title` field.			- `variant_title:'Special ski wax'`
vendor	string	Filter by the origin or source of the product. Learn more about vendors and managing vendor information.			- `vendor:Snowdevil` - `vendor:Snowdevil OR vendor:Icedevil`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

limit: Int -

The upper bound on count value before returning a result. Use null to have no limit.

After:

📝

Retrieves the total count of products published to a specific sales channel. Limited to a maximum of 10000 by default.

Type: Count

Arguments:

query: String -

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

name	type	description	acceptable_values	default_value	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.			- `query=Bob Norman` - `query=title:green hoodie`
barcode	string	Filter by the product variant `barcode` field.			- `barcode:ABC-abc-1234`
bundles	boolean	Filter by a product bundle. A product bundle is a set of two or more related products, which are commonly offered at a discount.			- `bundles:true`
category_id	string	Filter by the product category ID (`product.category.id`). A product category is the category of a product from Shopify's Standard Product Taxonomy.			- `category_id:sg-4-17-2-17`
collection_id	id	Filter by the collection `id` field.			- `collection_id:108179161409`
combined_listing_role	string	Filter by the role of the product in a combined listing.	- `parent` - `child` - `no_role`		- `combined_listing_role:parent`
created_at	time	Filter by the date and time when the product was created.			- `created_at:>'2020-10-21T23:39:20Z'` - `created_at:<now` - `created_at:<='2024'`
delivery_profile_id	id	Filter by the delivery profile `id` field.			- `delivery_profile_id:108179161409`
error_feedback	string	Filter by products with publishing errors.
gift_card	boolean	Filter by the product `isGiftCard` field.			- `gift_card:true`
handle	string	Filter by a comma-separated list of product handles.			- `handle:the-minimal-snowboard`
has_only_composites	boolean	Filter by products that have only composite variants.			- `has_only_composites:true`
has_only_default_variant	boolean	Filter by products that have only a default variant. A default variant is the only variant if no other variants are specified.			- `has_only_default_variant:true`
has_variant_with_components	boolean	Filter by products that have variants with associated components.			- `has_variant_with_components:true`
id	id	Filter by `id` range.			- `id:1234` - `id:>=1234` - `id:<=1234`
inventory_total	integer	Filter by inventory count.			- `inventory_total:0` - `inventory_total:>150` - `inventory_total:>=200`
is_price_reduced	boolean	Filter by products that have a reduced price. For more information, refer to the `CollectionRule` object.			- `is_price_reduced:true`
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"`
out_of_stock_somewhere	boolean	Filter by products that are out of stock in at least one location.			- `out_of_stock_somewhere:true`
price	bigdecimal	Filter by the product variant `price` field.			- `price:100.57`
product_configuration_owner	string	Filter by the app `id` field.			- `product_configuration_owner:10001`
product_publication_status	string	Filter by the publication status of the resource on a channel, such as the online store. The value is a composite of the channel `app` ID (`Channel.app.id`) and one of the valid values.	- `approved` - `rejected` - `needs_action` - `awaiting_review` - `published` - `demoted` - `scheduled` - `provisionally_published`		- `product_publication_status:189769876-approved`
product_type	string	Filter by a comma-separated list of product types.			- `product_type:snowboard`
publication_ids	string	Filter by a comma-separated list of publication IDs that are associated with the product.			- `publication_ids:184111530305,184111694145`
publishable_status	string	Filter by the publishable status of the resource on a channel, such as the online store. The value is a composite of either the channel `app` ID (`Channel.app.id`) or channel `name` and one of the valid values.	- `online_store_channel` - `published` - `unpublished` - `visible` - `unavailable` - `hidden` - `intended` - `visible`		- `publishable_status:published` - `publishable_status:189769876-visible` - `publishable_status:pos-hidden`
published_at	time	Filter by the date and time when the product was published to the online store and other sales channels.			- `published_at:>2020-10-21T23:39:20Z` - `published_at:<now` - `published_at:<=2024`
published_status	string	Filter by the published status of the resource on a channel, such as the online store.	- `unset` - `pending` - `approved` - `not approved`		- `published_status:approved`
sku	string	Filter by the product variant `sku` field. Learn more about SKUs.			- `sku:XYZ-12345`
status	string	Filter by a comma-separated list of statuses. You can use statuses to manage inventory. Shopify only displays products with an `ACTIVE` status in online stores, sales channels, and apps.	- `active` - `archived` - `draft`	`active`	- `status:active,draft`
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`
title	string	Filter by the product `title` field.			- `title:The Minimal Snowboard`
updated_at	time	Filter by the date and time when the product was last updated.			- `updated_at:>'2020-10-21T23:39:20Z'` - `updated_at:<now` - `updated_at:<='2024'`
variant_id	id	Filter by the product variant `id` field.			- `variant_id:45779434701121`
variant_title	string	Filter by the product variant `title` field.			- `variant_title:'Special ski wax'`
vendor	string	Filter by the origin or source of the product. Learn more about vendors and managing vendor information.			- `vendor:Snowdevil` - `vendor:Snowdevil OR vendor:Icedevil`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

limit: Int -

The upper bound on count value before returning a result. Use null to have no limit.

🏗️CheckoutAndAccountsAppConfiguration🔄 Modified

➖ Field removed: apiClientId

➖ Field removed: brandingConfiguration

➖ Field removed: featureConfiguration

➖ Field removed: shopId

➕ Field added: feature

The feature configuration for checkout and accounts app.

🏗️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 channel information `handle` (`ChannelInformation.channelDefinition.handle`) field.		- `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. 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`
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 channel information `handle` (`ChannelInformation.channelDefinition.handle`) field.		- `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`
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 channel information `handle` (`ChannelInformation.channelDefinition.handle`) field.		- `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. 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`
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 channel information `handle` (`ChannelInformation.channelDefinition.handle`) field.		- `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`
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.

🏗️DisputeStatus🔄 Modified

➕ Enum value added: PREVENTED

🏗️InventoryShipmentAddItemsUserErrorCode🔄 Modified

➖ Enum value removed: LOCATION_NOT_FOUND

🏗️InventoryShipmentReceiveUserErrorCode🔄 Modified

➖ Enum value removed: LOCATION_NOT_FOUND

🏗️InventoryShipmentRemoveItemsUserErrorCode🔄 Modified

➖ Enum value removed: LOCATION_NOT_FOUND

🏗️InventoryShipmentUpdateItemQuantitiesUserErrorCode🔄 Modified

➖ Enum value removed: LOCATION_NOT_FOUND

🏗️MarketUserErrorCode🔄 Modified

➕ Enum value added: CANNOT_DELETE_PROVINCE_MARKET

➕ Enum value added: INVALID_CUSTOMIZATION_FOR_PROVINCE_CONDITION

🏗️MetafieldDefinitionCreateUserErrorCode🔄 Modified

➕ Enum value added: RESOURCE_TYPE_LIMIT_EXCEEDED_BY_APP

🏗️MetafieldDefinitionDeleteUserErrorCode🔄 Modified

➕ Enum value added: STANDARD_METAFIELD_DEFINITION_DEPENDENT_ON_APP

🏗️MetafieldDefinitionUpdateUserErrorCode🔄 Modified

➕ Enum value added: INVALID

🏗️MetaobjectUserErrorCode🔄 Modified

➕ Enum value added: STANDARD_METAOBJECT_DEFINITION_DEPENDENT_ON_APP

🏗️Order🔄 Modified

➖ Field removed: sharedCheckout

➕ Field added: productNetwork

Whether the customer also purchased items from other stores in the network.

🏗️PriceRuleCustomerSelection🔄 Modified

🔄 Field modified: customers

Before:

📝

List of customers to whom the price rule applies.

Type: CustomerConnection!

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: CustomerSortKeys -

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	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.	- `query=Bob Norman` - `query=title:green hoodie`
accepts_marketing	boolean	Filter by whether a customer has consented to receive marketing material.	- `accepts_marketing:true`
country	string	Filter by the country associated with the customer's address. Use either the country name or the two-letter country code.	- `country:Canada` - `country:JP`
customer_date	time	Filter by the date and time when the customer record was created. This query parameter filters by the `createdAt` field.	- `customer_date:'2024-03-15T14:30:00Z'` - `customer_date:'>=2024-01-01'`
email	string	The customer's email address, used to communicate information about orders and for the purposes of email marketing campaigns. You can use a wildcard value to filter the query by customers who have an email address specified. Please note that email is a tokenized field: To retrieve exact matches, quote the email address (phrase query) as described in Shopify API search syntax.	- `email:gmail.com` - `email:"bo.wang@example.com"` - `email:*`
first_name	string	Filter by the customer's first name.	- `first_name:Jane`
id	id	Filter by `id` range.	- `id:1234` - `id:>=1234` - `id:<=1234`
last_abandoned_order_date	time	Filter by the date and time of the customer's most recent abandoned checkout. An abandoned checkout occurs when a customer adds items to their cart, begins the checkout process, but leaves the site without completing their purchase.	- `last_abandoned_order_date:'2024-04-01T10:00:00Z'` - `last_abandoned_order_date:'>=2024-01-01'`
last_name	string	Filter by the customer's last name.	- `last_name:Reeves`
order_date	time	Filter by the date and time that the order was placed by the customer. Use this query filter to check if a customer has placed at least one order within a specified date range.	- `order_date:'2024-02-20T00:00:00Z'` - `order_date:'>=2024-01-01'` - `order_date:'2024-01-01..2024-03-31'`
orders_count	integer	Filter by the total number of orders a customer has placed.	- `orders_count:5`
phone	string	The phone number of the customer, used to communicate information about orders and for the purposes of SMS marketing campaigns. You can use a wildcard value to filter the query by customers who have a phone number specified.	- `phone:+18005550100` - `phone:*`
state	string	Filter by the state of the customer's account with the shop. This filter is only valid when Classic Customer Accounts is active.	- `state:ENABLED` - `state:INVITED` - `state:DISABLED` - `state:DECLINED`
tag	string	Filter by the tags that are associated with the customer. This query parameter accepts multiple tags separated by commas.	- `tag:'VIP'` - `tag:'Wholesale,Repeat'`
tag_not	string	Filter by the tags that aren't associated with the customer. This query parameter accepts multiple tags separated by commas.	- `tag_not:'Prospect'` - `tag_not:'Test,Internal'`
total_spent	float	Filter by the total amount of money a customer has spent across all orders.	- `total_spent:100.50` - `total_spent:50.00` - `total_spent:>100.50` - `total_spent:>50.00`
updated_at	time	The date and time, matching a whole day, when the customer's information was last updated.	- `updated_at:2024-01-01T00:00:00Z` - `updated_at:<now` - `updated_at:<=2024`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

savedSearchId: ID -

The ID of a saved search.
The search’s query string is used as the query argument.

After:

📝

List of customers to whom the price rule applies.

Type: CustomerConnection!

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: CustomerSortKeys -

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	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.	- `query=Bob Norman` - `query=title:green hoodie`
accepts_marketing	boolean	Filter by whether a customer has consented to receive marketing material.	- `accepts_marketing:true`
country	string	Filter by the country associated with the customer's address. Use either the country name or the two-letter country code.	- `country:Canada` - `country:JP`
customer_date	time	Filter by the date and time when the customer record was created. This query parameter filters by the `createdAt` field.	- `customer_date:'2024-03-15T14:30:00Z'` - `customer_date: >='2024-01-01'`
email	string	The customer's email address, used to communicate information about orders and for the purposes of email marketing campaigns. You can use a wildcard value to filter the query by customers who have an email address specified. Please note that email is a tokenized field: To retrieve exact matches, quote the email address (phrase query) as described in Shopify API search syntax.	- `email:gmail.com` - `email:"bo.wang@example.com"` - `email:*`
first_name	string	Filter by the customer's first name.	- `first_name:Jane`
id	id	Filter by `id` range.	- `id:1234` - `id:>=1234` - `id:<=1234`
last_abandoned_order_date	time	Filter by the date and time of the customer's most recent abandoned checkout. An abandoned checkout occurs when a customer adds items to their cart, begins the checkout process, but leaves the site without completing their purchase.	- `last_abandoned_order_date:'2024-04-01T10:00:00Z'` - `last_abandoned_order_date: >='2024-01-01'`
last_name	string	Filter by the customer's last name.	- `last_name:Reeves`
order_date	time	Filter by the date and time that the order was placed by the customer. Use this query filter to check if a customer has placed at least one order within a specified date range.	- `order_date:'2024-02-20T00:00:00Z'` - `order_date: >='2024-01-01'` - `order_date:'2024-01-01..2024-03-31'`
orders_count	integer	Filter by the total number of orders a customer has placed.	- `orders_count:5`
phone	string	The phone number of the customer, used to communicate information about orders and for the purposes of SMS marketing campaigns. You can use a wildcard value to filter the query by customers who have a phone number specified.	- `phone:+18005550100` - `phone:*`
state	string	Filter by the state of the customer's account with the shop. This filter is only valid when Classic Customer Accounts is active.	- `state:ENABLED` - `state:INVITED` - `state:DISABLED` - `state:DECLINED`
tag	string	Filter by the tags that are associated with the customer. This query parameter accepts multiple tags separated by commas.	- `tag:'VIP'` - `tag:'Wholesale,Repeat'`
tag_not	string	Filter by the tags that aren't associated with the customer. This query parameter accepts multiple tags separated by commas.	- `tag_not:'Prospect'` - `tag_not:'Test,Internal'`
total_spent	float	Filter by the total amount of money a customer has spent across all orders.	- `total_spent:100.50` - `total_spent:50.00` - `total_spent:>100.50` - `total_spent:>50.00`
updated_at	time	The date and time, matching a whole day, when the customer's information was last updated.	- `updated_at:2024-01-01T00:00:00Z` - `updated_at:<now` - `updated_at:<=2024`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

savedSearchId: ID -

The ID of a saved search.
The search’s query string is used as the query argument.

🏗️ProductBundleCreatePayload🔄 Modified

🔄 Field modified: productBundleOperation

🏗️ProductBundleUpdatePayload🔄 Modified

🔄 Field modified: productBundleOperation

🏗️ProductVariant🔄 Modified

🔄 Field modified: image

🏗️Shop🔄 Modified

➖ Field removed: draftOrders

➕ Field added: appTrialEligible

Whether the shop is eligible for app trials offered by third-party apps.

🔄 Field modified: customers

Before:

📝

Customer accounts associated to the shop.

Type: CustomerConnection!

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: CustomerSortKeys -

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	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.	- `query=Bob Norman` - `query=title:green hoodie`
accepts_marketing	boolean	Filter by whether a customer has consented to receive marketing material.	- `accepts_marketing:true`
country	string	Filter by the country associated with the customer's address. Use either the country name or the two-letter country code.	- `country:Canada` - `country:JP`
customer_date	time	Filter by the date and time when the customer record was created. This query parameter filters by the `createdAt` field.	- `customer_date:'2024-03-15T14:30:00Z'` - `customer_date:'>=2024-01-01'`
email	string	The customer's email address, used to communicate information about orders and for the purposes of email marketing campaigns. You can use a wildcard value to filter the query by customers who have an email address specified. Please note that email is a tokenized field: To retrieve exact matches, quote the email address (phrase query) as described in Shopify API search syntax.	- `email:gmail.com` - `email:"bo.wang@example.com"` - `email:*`
first_name	string	Filter by the customer's first name.	- `first_name:Jane`
id	id	Filter by `id` range.	- `id:1234` - `id:>=1234` - `id:<=1234`
last_abandoned_order_date	time	Filter by the date and time of the customer's most recent abandoned checkout. An abandoned checkout occurs when a customer adds items to their cart, begins the checkout process, but leaves the site without completing their purchase.	- `last_abandoned_order_date:'2024-04-01T10:00:00Z'` - `last_abandoned_order_date:'>=2024-01-01'`
last_name	string	Filter by the customer's last name.	- `last_name:Reeves`
order_date	time	Filter by the date and time that the order was placed by the customer. Use this query filter to check if a customer has placed at least one order within a specified date range.	- `order_date:'2024-02-20T00:00:00Z'` - `order_date:'>=2024-01-01'` - `order_date:'2024-01-01..2024-03-31'`
orders_count	integer	Filter by the total number of orders a customer has placed.	- `orders_count:5`
phone	string	The phone number of the customer, used to communicate information about orders and for the purposes of SMS marketing campaigns. You can use a wildcard value to filter the query by customers who have a phone number specified.	- `phone:+18005550100` - `phone:*`
state	string	Filter by the state of the customer's account with the shop. This filter is only valid when Classic Customer Accounts is active.	- `state:ENABLED` - `state:INVITED` - `state:DISABLED` - `state:DECLINED`
tag	string	Filter by the tags that are associated with the customer. This query parameter accepts multiple tags separated by commas.	- `tag:'VIP'` - `tag:'Wholesale,Repeat'`
tag_not	string	Filter by the tags that aren't associated with the customer. This query parameter accepts multiple tags separated by commas.	- `tag_not:'Prospect'` - `tag_not:'Test,Internal'`
total_spent	float	Filter by the total amount of money a customer has spent across all orders.	- `total_spent:100.50` - `total_spent:50.00` - `total_spent:>100.50` - `total_spent:>50.00`
updated_at	time	The date and time, matching a whole day, when the customer's information was last updated.	- `updated_at:2024-01-01T00:00:00Z` - `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.customers` instead.

After:

📝

Customer accounts associated to the shop.

Type: CustomerConnection!

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: CustomerSortKeys -

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	example_use
default	string	Filter by a case-insensitive search of multiple fields in a document.	- `query=Bob Norman` - `query=title:green hoodie`
accepts_marketing	boolean	Filter by whether a customer has consented to receive marketing material.	- `accepts_marketing:true`
country	string	Filter by the country associated with the customer's address. Use either the country name or the two-letter country code.	- `country:Canada` - `country:JP`
customer_date	time	Filter by the date and time when the customer record was created. This query parameter filters by the `createdAt` field.	- `customer_date:'2024-03-15T14:30:00Z'` - `customer_date: >='2024-01-01'`
email	string	The customer's email address, used to communicate information about orders and for the purposes of email marketing campaigns. You can use a wildcard value to filter the query by customers who have an email address specified. Please note that email is a tokenized field: To retrieve exact matches, quote the email address (phrase query) as described in Shopify API search syntax.	- `email:gmail.com` - `email:"bo.wang@example.com"` - `email:*`
first_name	string	Filter by the customer's first name.	- `first_name:Jane`
id	id	Filter by `id` range.	- `id:1234` - `id:>=1234` - `id:<=1234`
last_abandoned_order_date	time	Filter by the date and time of the customer's most recent abandoned checkout. An abandoned checkout occurs when a customer adds items to their cart, begins the checkout process, but leaves the site without completing their purchase.	- `last_abandoned_order_date:'2024-04-01T10:00:00Z'` - `last_abandoned_order_date: >='2024-01-01'`
last_name	string	Filter by the customer's last name.	- `last_name:Reeves`
order_date	time	Filter by the date and time that the order was placed by the customer. Use this query filter to check if a customer has placed at least one order within a specified date range.	- `order_date:'2024-02-20T00:00:00Z'` - `order_date: >='2024-01-01'` - `order_date:'2024-01-01..2024-03-31'`
orders_count	integer	Filter by the total number of orders a customer has placed.	- `orders_count:5`
phone	string	The phone number of the customer, used to communicate information about orders and for the purposes of SMS marketing campaigns. You can use a wildcard value to filter the query by customers who have a phone number specified.	- `phone:+18005550100` - `phone:*`
state	string	Filter by the state of the customer's account with the shop. This filter is only valid when Classic Customer Accounts is active.	- `state:ENABLED` - `state:INVITED` - `state:DISABLED` - `state:DECLINED`
tag	string	Filter by the tags that are associated with the customer. This query parameter accepts multiple tags separated by commas.	- `tag:'VIP'` - `tag:'Wholesale,Repeat'`
tag_not	string	Filter by the tags that aren't associated with the customer. This query parameter accepts multiple tags separated by commas.	- `tag_not:'Prospect'` - `tag_not:'Test,Internal'`
total_spent	float	Filter by the total amount of money a customer has spent across all orders.	- `total_spent:100.50` - `total_spent:50.00` - `total_spent:>100.50` - `total_spent:>50.00`
updated_at	time	The date and time, matching a whole day, when the customer's information was last updated.	- `updated_at:2024-01-01T00:00:00Z` - `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.customers` instead.

🔄 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 channel information `handle` (`ChannelInformation.channelDefinition.handle`) field.		- `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. 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`
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 channel information `handle` (`ChannelInformation.channelDefinition.handle`) field.		- `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`
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.

➕ Field added: thirdPartyAppSubscriptionOverride

All third party app subscription overrides for the shop.

🏗️ShopifyPaymentsDisputeEvidenceFileType🔄 Modified

➕ Enum value added: RESPONSE_SUMMARY_FILE

🏗️ShopifyPaymentsTransactionType🔄 Modified

➕ Enum value added: ADS_PUBLISHER_CREDIT

➕ Enum value added: ADS_PUBLISHER_CREDIT_REVERSAL

➕ Enum value added: INSTALLMENTS_BALANCE_RECOVERY_DEBIT

➕ Enum value added: INSTALLMENTS_BALANCE_RECOVERY_DEBIT_REVERSAL

➕ Enum value added: MANAGED_MARKETS_DUTIES_AND_TAXES_ADJUSTMENT_PLATFORM_DEBIT

➕ Enum value added: MANAGED_MARKETS_DUTIES_AND_TAXES_ADJUSTMENT_PLATFORM_CREDIT

➕ Enum value added: MANAGED_MARKETS_DUTIES_AND_TAXES_ADJUSTMENT_PLATFORM_DEBIT_REVERSAL

➕ Enum value added: MANAGED_MARKETS_DUTIES_AND_TAXES_ADJUSTMENT_PLATFORM_CREDIT_REVERSAL

➕ Enum value added: MANAGED_MARKETS_MERCHANT_OF_RECORD_ACCOUNT_NETTING_CREDIT

➕ Enum value added: MANAGED_MARKETS_MERCHANT_OF_RECORD_ACCOUNT_NETTING_CREDIT_REVERSAL

➕ Enum value added: MANAGED_MARKETS_MERCHANT_OF_RECORD_ACCOUNT_NETTING_DEBIT

➕ Enum value added: MANAGED_MARKETS_MERCHANT_OF_RECORD_ACCOUNT_NETTING_DEBIT_REVERSAL

🏗️SubscriptionBillingAttemptErrorCode🔄 Modified

➖ Enum value removed: CURRENCY_NOT_ENABLED

Add Channels Query, Revamp Descriptions, Update Filters

Query Changes

➕ Added Queries (1)

🔄 Modified Queries (14)

Mutation Changes

🔄 Modified Mutations (11)

Fulfillment service location

Type Changes

➕ Added Types (1)

🔄 Modified Types (23)

Field Modified: productsCount on Channel

Before:

After:

Field Modified: orders on Company

Before:

After:

Field Modified: orders on Customer

Before:

After:

Field Modified: customers on PriceRuleCustomerSelection

Before:

After:

Field Modified: productBundleOperation on ProductBundleCreatePayload

Before:

After:

Field Modified: productBundleOperation on ProductBundleUpdatePayload

Before:

After:

Field Modified: image on ProductVariant

Before:

After:

Field Modified: customers on Shop

Before:

After:

Field Modified: orders on Shop

Before:

After:

Field Modified: `productsCount` on `Channel`

Field Modified: `orders` on `Company`

Field Modified: `orders` on `Customer`

Field Modified: `customers` on `PriceRuleCustomerSelection`

Field Modified: `productBundleOperation` on `ProductBundleCreatePayload`

Field Modified: `productBundleOperation` on `ProductBundleUpdatePayload`

Field Modified: `image` on `ProductVariant`

Field Modified: `customers` on `Shop`

Field Modified: `orders` on `Shop`