Developer changelog

Added minRange and maxRange fields to segment filters in the Admin GraphQL API to expose valid value ranges for customer segmentation.

New DraftOrderMarketRegionCountryCodeNotSupportedWarning added for DraftOrder. Warns if deprecated marketRegionCountryCode is set, as it doesn't affect draft orders on shops using Markets.

The orderCancel mutation now allows refunds to be issued to store credit. A new refundMethod input deprecates the existing refund input, providing greater flexibility.

API version 2025-07 allows filtering Order.fulfillments by created_at and updated_at using familiar query syntax, enhancing search precision without altering default behavior.

The discountClass field is deprecated; use discountClasses for multiple discount classes. Continue using presentationLevel to see DraftOrderPlatformDiscount effects.

Starting July 2025, third-party apps can self-uninstall via a new GraphQL mutation.

API version 2025-07 includes new fields to help you process returns

New removeFromReturn mutation lets Partners remove unprocessed return and exchange items, replacing the older mutation. Available in unstable and 2025-07 GraphQL API versions.

New GraphQL fields let you view return timestamps and track quantities through processing.

API version 2025-07 increases draft order line item limit from 250 to 499

API 2025-07: Fulfillment service apps can now use estimatedShippedAt to specify estimated fulfillment order completion, enhancing shipment tracking accuracy for merchants.

New groupObjects argument in GraphQL Admin API allows disabling object grouping for faster, more reliable bulk operations by setting it to false.

Shop metafields are now visible in the Admin UI, eliminating custom interface development. Developers can easily build apps using shop-level data with built-in viewing and editing capabilities.

From 2025-07, productCreate will return userErrors for duplicate or conflicting metafield links, invalid linkedMetafieldValue or optionValues specifications, and conflicting option parameters.

Adds fields for device, location, and currency exchange in OrderTransaction; and a processed_at field in OrderCreateManualPayment to manually specify payment time.

GraphQL now includes orderCustomerRemove and orderCustomerSet mutations and an Order.number field, so you can manage customers on orders programatically.

Shopify Admin API updates: returnRefund deprecated, replaced by returnProcess for streamlined return management. Available now in unstable, official release in 2025-07.

Adds a title filter to the articles Admin API query.

GraphQL count APIs now return uncapped results with limit=null. All APIs standardized; limit defaults to 10000, introducing a breaking change.

New API endpoint retrieves delivery options for draft orders, including shipping rates and local pickup, with pagination. Requires read_draft_orders access scope. Replaces legacy field.

The release candidate for version 2025-07 of the Storefront, GraphQL Admin, and Customer Account APIs now support imperial units and count measurements, enabling more transparent pricing.

API version 2025-07 deprecates the draftOrderCreateMerchantCheckout mutation.

Shopify's GraphQL now supports retrieving Shop Pay payment details using source_identifier or receipt token, streamlining workflows for merchants using Shop Component.

productSet mutation returns more precise PRODUCT_SUSPENDED error code

The publicDisplayName field is added to ShopPlan. The Shopify plan is now Grow. Update to publicDisplayName as displayName will be deprecated.

Automatically create smart collections with the new PRODUCT_CATEGORY_ID_WITH_DESCENDANTS field.

The draftOrderCount query is now available in the 2025-07 stable version of the GraphQL Admin API. Previously, it was...

Locations can now be used in delivery promise participant queries and mutations in the unstable GraphQL Admin API, with full release in 2025-07. Filter products by delivery promise participants.

As of 2025-07, FeeSale.fee is nullable, allowing null values for deleted fees. Prior versions return deleted fees. Update your code to handle null fees.

The description field for metafields is being removed in unstable.