--- title: Recent changes to Shopify’s platform description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities. source_url: html: https://shopify.dev/changelog?api_type=admin-graphql&api_version=2025-07 md: https://shopify.dev/changelog.md?api_type=admin-graphql&api_version=2025-07 --- # Developer changelog Subscribe to the changelog to stay up to date on recent changes to Shopify’s APIs and other developer products, as well as preview upcoming features and beta releases. [RSS Updates](https://shopify.dev/changelog/feed.xml) * July 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [New range fields available for segment filters in GraphQL Admin API](https://shopify.dev/changelog/new-range-fields-available-for-segment-filters-in-graphql-admin-api) Added `minRange` and `maxRange` fields to segment filters in the Admin GraphQL API to expose valid value ranges for customer segmentation. [Read full post –>](https://shopify.dev/changelog/new-range-fields-available-for-segment-filters-in-graphql-admin-api) * July 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [New warning `DraftOrderMarketRegionCountryCodeNotSupportedWarning` added to `DraftOrder`](https://shopify.dev/changelog/new-warning-draftordermarketregioncountrycodenotsupportedwarning-added-to-draftorder) New `DraftOrderMarketRegionCountryCodeNotSupportedWarning` added for `DraftOrder`. Warns if deprecated `marketRegionCountryCode` is set, as it doesn't affect draft orders on shops using Markets. [Read full post –>](https://shopify.dev/changelog/new-warning-draftordermarketregioncountrycodenotsupportedwarning-added-to-draftorder) * July 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Order cancellation now supports refunds to store credit](https://shopify.dev/changelog/ordercancel-mutation-now-supports-refunds-to-store-credit) The `orderCancel` mutation now allows refunds to be issued to store credit. A new `refundMethod` input deprecates the existing `refund` input, providing greater flexibility. [Read full post –>](https://shopify.dev/changelog/ordercancel-mutation-now-supports-refunds-to-store-credit) * July 1, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [New field for discount classes on `DraftOrderPlatformDiscount`](https://shopify.dev/changelog/new-field-for-discount-classes-on-draftorderplatformdiscount) The `discountClass` field is deprecated; use `discountClasses` for multiple discount classes. Continue using `presentationLevel` to see `DraftOrderPlatformDiscount` effects. [Read full post –>](https://shopify.dev/changelog/new-field-for-discount-classes-on-draftorderplatformdiscount) * July 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Add created/updated at time based filters for an order's fulfillments](https://shopify.dev/changelog/add-createdupdated-at-time-based-filters-for-an-orders-fulfillments) 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. [Read full post –>](https://shopify.dev/changelog/add-createdupdated-at-time-based-filters-for-an-orders-fulfillments) * July 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [New AppUninstall mutation to allow apps to uninstall themselves.](https://shopify.dev/changelog/new-appuninstall-mutation-to-allow-apps-to-uninstall-themselves) Starting July 2025, third-party apps can self-uninstall via a new GraphQL mutation. [Read full post –>](https://shopify.dev/changelog/new-appuninstall-mutation-to-allow-apps-to-uninstall-themselves) * July 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Returns Processing APIs replaces Return Refund APIs](https://shopify.dev/changelog/returns-processing-api) API version 2025-07 includes new fields to help you process returns [Read full post –>](https://shopify.dev/changelog/returns-processing-api) * July 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [New GraphQL fields for return management](https://shopify.dev/changelog/new-graphql-fields-for-return-management) New GraphQL fields let you view return timestamps and track quantities through processing. [Read full post –>](https://shopify.dev/changelog/new-graphql-fields-for-return-management) * July 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Remove unprocessed exchange lines from a return](https://shopify.dev/changelog/remove-unprocessed-exchange-lines-from-a-return) New `removeFromReturn` mutation lets Partners remove unprocessed return and exchange items, replacing the older mutation. Available in `unstable` and `2025-07` GraphQL API versions. [Read full post –>](https://shopify.dev/changelog/remove-unprocessed-exchange-lines-from-a-return) * June 30, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Increase draft order line item limit from `250` to `499`](https://shopify.dev/changelog/draft-order-line-item-limit) API version `2025-07` increases draft order line item limit from `250` to `499` [Read full post –>](https://shopify.dev/changelog/draft-order-line-item-limit) * June 30, 2025 Tags: * Admin GraphQL API * 2025-07 ### [New `estimatedShippedAt` argument added to FulfillmentOrderAcceptFulfillmentRequest mutation](https://shopify.dev/changelog/new-estimatedshippedat-argument-added-to-fulfillmentorderacceptfulfillmentrequest-mutation) API 2025-07: Fulfillment service apps can now use `estimatedShippedAt` to specify estimated fulfillment order completion, enhancing shipment tracking accuracy for merchants. [Read full post –>](https://shopify.dev/changelog/new-estimatedshippedat-argument-added-to-fulfillmentorderacceptfulfillmentrequest-mutation) * June 27, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Optional `groupObjects` argument in bulk operations mutations that offers faster and more reliable job execution](https://shopify.dev/changelog/optional-groupobjects-argument-in-bulk-operations-mutations-that-offers-faster-and-more-reliable-job-execution) New `groupObjects` argument in GraphQL Admin API allows disabling object grouping for faster, more reliable bulk operations by setting it to `false`. [Read full post –>](https://shopify.dev/changelog/optional-groupobjects-argument-in-bulk-operations-mutations-that-offers-faster-and-more-reliable-job-execution) * June 23, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Shop metafield definitions are now available in the Shopify Admin and Admin API](https://shopify.dev/changelog/shop-metafield-now-in-admin) 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. [Read full post –>](https://shopify.dev/changelog/shop-metafield-now-in-admin) * June 14, 2025 Tags: * Admin GraphQL API * 2025-07 ### [`productCreate` surfaces input errors as `userErrors`](https://shopify.dev/changelog/product-create-serves-input-errors-as-user-errors) From 2025-07, `productCreate` will return `userErrors` for duplicate or conflicting metafield links, invalid `linkedMetafieldValue` or `optionValues` specifications, and conflicting option parameters. [Read full post –>](https://shopify.dev/changelog/product-create-serves-input-errors-as-user-errors) * June 13, 2025 Tags: * Admin GraphQL API * 2025-07 ### [New fields for OrderTransaction and OrderCreateManualPayment](https://shopify.dev/changelog/added-new-fields-to-transaction-related-objects-and-mutations) Adds fields for device, location, and currency exchange in OrderTransaction; and a processed\_at field in OrderCreateManualPayment to manually specify payment time. [Read full post –>](https://shopify.dev/changelog/added-new-fields-to-transaction-related-objects-and-mutations) * May 23, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Add and remove customers from an order with GraphQL](https://shopify.dev/changelog/orders-number-and-customer-graphql-update) GraphQL now includes `orderCustomerRemove` and `orderCustomerSet` mutations and an `Order.number` field, so you can manage customers on orders programatically. [Read full post –>](https://shopify.dev/changelog/orders-number-and-customer-graphql-update) * May 21, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Deprecation of legacy return APIs and improvements to return management](https://shopify.dev/changelog/deprecation-of-legacy-return-apis-and-improvements-to-return-management) Shopify Admin API updates: returnRefund deprecated, replaced by returnProcess for streamlined return management. Available now in unstable, official release in 2025-07. [Read full post –>](https://shopify.dev/changelog/deprecation-of-legacy-return-apis-and-improvements-to-return-management) * May 21, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Filter articles by title](https://shopify.dev/changelog/add-support-for-title-filtering-with-articles) Adds a `title` filter to the `articles` Admin API query. [Read full post –>](https://shopify.dev/changelog/add-support-for-title-filtering-with-articles) * May 21, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Uncapped counts in GraphQL](https://shopify.dev/changelog/uncapped-graphql-counts) GraphQL count APIs now return uncapped results with `limit=null`. All APIs standardized; `limit` defaults to `10000`, introducing a breaking change. [Read full post –>](https://shopify.dev/changelog/uncapped-graphql-counts) * May 20, 2025 Tags: * Admin GraphQL API * 2025-07 ### [New GraphQL API for Draft Order Delivery Options for Developers](https://shopify.dev/changelog/new-graphql-api-for-draft-order-delivery-options-for-developers) 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. [Read full post –>](https://shopify.dev/changelog/new-graphql-api-for-draft-order-delivery-options-for-developers) * May 2, 2025 Tags: * Admin GraphQL API * Customer Account API * Storefront GraphQL API * 2025-07 ### [The `UnitPriceMeasurementMeasuredUnit` enum now includes imperial units and counts](https://shopify.dev/changelog/unit-pricing-api-update) 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. [Read full post –>](https://shopify.dev/changelog/unit-pricing-api-update) * May 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Deprecation of `draftOrderCreateMerchantCheckout` mutation](https://shopify.dev/changelog/deprecation-of-draftordercreatemerchantcheckout-mutation) API version 2025-07 deprecates the `draftOrderCreateMerchantCheckout` mutation. [Read full post –>](https://shopify.dev/changelog/deprecation-of-draftordercreatemerchantcheckout-mutation) * May 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Shop Component: Shop Pay Payment Request Receipt queries](https://shopify.dev/changelog/shop-component-shop-pay-payment-request-receipt-queries) Shopify's GraphQL now supports retrieving Shop Pay payment details using `source_identifier` or receipt token, streamlining workflows for merchants using Shop Component. [Read full post –>](https://shopify.dev/changelog/shop-component-shop-pay-payment-request-receipt-queries) * April 17, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Change in `productSet` mutation error code for suspended product](https://shopify.dev/changelog/change-in-productset-mutation-error-code-for-suspended-product) `productSet` mutation returns more precise `PRODUCT_SUSPENDED` error code [Read full post –>](https://shopify.dev/changelog/change-in-productset-mutation-error-code-for-suspended-product) * April 17, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Adding `publicDisplayName` field on `ShopPlan`](https://shopify.dev/changelog/adding-publicdisplayname-field-on-shopplan) The `publicDisplayName` field is added to `ShopPlan`. The `Shopify` plan is now `Grow`. Update to `publicDisplayName` as `displayName` will be deprecated. [Read full post –>](https://shopify.dev/changelog/adding-publicdisplayname-field-on-shopplan) * April 14, 2025 Tags: * Admin GraphQL API * 2025-07 ### [Create smart collections automatically with PRODUCT\_CATEGORY\_ID\_WITH\_DESCENDANTS](https://shopify.dev/changelog/introducing-productcategoryidwithdescendants-in-collectionrulecolumn-for-smart-collections) Automatically create smart collections with the new PRODUCT\_CATEGORY\_ID\_WITH\_DESCENDANTS field. [Read full post –>](https://shopify.dev/changelog/introducing-productcategoryidwithdescendants-in-collectionrulecolumn-for-smart-collections) * April 1, 2025 Tags: * Admin GraphQL API * 2025-07 ### [`draftOrderCount` available in 2025-07](https://shopify.dev/changelog/draftordercount-available-in-2025-07) The [`draftOrderCount`](https://shopify.dev/docs/api/admin-graphql/2025-07/queries/draftOrderCount) query is now available in the 2025-07 stable version of the GraphQL Admin API. Previously, it was... [Read full post –>](https://shopify.dev/changelog/draftordercount-available-in-2025-07) * March 31, 2025 Tags: * Admin GraphQL API * 2025-07 ### [New additions to delivery promise participants APIs](https://shopify.dev/changelog/new-additions-to-delivery-promise-participants-apis) 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. [Read full post –>](https://shopify.dev/changelog/new-additions-to-delivery-promise-participants-apis) * March 18, 2025 Tags: * Admin GraphQL API * 2025-07 ### [FeeSale fee field is nullable as of 2025-07](https://shopify.dev/changelog/feesale-fee-field-is-nullable-as-of-2025-07) 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. [Read full post –>](https://shopify.dev/changelog/feesale-fee-field-is-nullable-as-of-2025-07) * February 27, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Metafield description input field removal](https://shopify.dev/changelog/metafield-description-field-removal) The `description` field for metafields is being removed in `unstable`. [Read full post –>](https://shopify.dev/changelog/metafield-description-field-removal) * December 19, 2024 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Deprecated `SubscriptionMailingAddress` in favor of `MailingAddress`](https://shopify.dev/changelog/deprecate-subscriptionmailingaddress-in-favour-of-mailingaddress) The 2025-07 version of the GraphQL Admin API deprecates `SubscriptionMailingAddress`. Use `MailingAddress` for future implementations. [Read full post –>](https://shopify.dev/changelog/deprecate-subscriptionmailingaddress-in-favour-of-mailingaddress)