--- 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-04 md: https://shopify.dev/changelog.md?api_type=admin-graphql&api_version=2025-04 --- # 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) * April 1, 2025 Tags: * Admin GraphQL API * Webhook * 2025-04 ### [New `planHandle` field for managed pricing app subscription plans](https://shopify.dev/changelog/new-planhandle-field-managed-pricing) App subscription plans now include persistent plan handles, making it easier to query for plan data. [Read full post –>](https://shopify.dev/changelog/new-planhandle-field-managed-pricing) * April 1, 2025 Tags: * Admin GraphQL API * Admin REST API * 2025-04 ### [New fees and net fields for balance transactions](https://shopify.dev/changelog/new-fees-and-net-fields-for-balance-transactions) API version 2025-04 adds fees and net fields to the GraphQL and REST Admin APIs for adjustment orders, which are helpful for financial reconciliation in balance transactions [Read full post –>](https://shopify.dev/changelog/new-fees-and-net-fields-for-balance-transactions) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Expanded control of privacy settings using the GraphQL Admin API](https://shopify.dev/changelog/expanded-control-of-privacy-settings-using-the-graphql-admin-api) API version 2025-04 lets you manage shop privacy settings, including cookie banners, data sale opt-outs, and privacy policy automation. [Read full post –>](https://shopify.dev/changelog/expanded-control-of-privacy-settings-using-the-graphql-admin-api) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Adding defaultEmailAddress field to Customer](https://shopify.dev/changelog/adding-defaultemailaddress-field-to-customer) As of GraphQL Admin API version **2025-04**, the `defaultEmailAddress` field is introduced on the `Customer` object to support querying a customer's email address and marketing state. Learn more... [Read full post –>](https://shopify.dev/changelog/adding-defaultemailaddress-field-to-customer) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Customer RFM group now available in GraphQL Admin API](https://shopify.dev/changelog/customer-rfm-group-now-available-in-graphql-admin-api) Added rfmGroup field to customer statistics in the Admin GraphQL Admin API to expose customer segmentation data based on purchasing patterns. [Read full post –>](https://shopify.dev/changelog/customer-rfm-group-now-available-in-graphql-admin-api) * April 1, 2025 Tags: * Admin GraphQL API * Webhook * 2025-04 ### [New finance KYC information field available for Shopify-approved finance apps](https://shopify.dev/changelog/new-finance-kyc-information-field-available-for-shopify-approved-finance-apps) Shopify-approved finance apps can access shop finance details and subscribe to related webhooks [Read full post –>](https://shopify.dev/changelog/new-finance-kyc-information-field-available-for-shopify-approved-finance-apps) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [New theme file metadata fields added to `OnlineStoreThemeFileOperationResult `object](https://shopify.dev/changelog/new-theme-file-metadata-fields-added-to-onlinestorethemefileoperationresult-object) The `themeFilesUpsert` mutation now returns theme file metadata directly, eliminating the need for extra fetch requests to verify updates. [Read full post –>](https://shopify.dev/changelog/new-theme-file-metadata-fields-added-to-onlinestorethemefileoperationresult-object) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [New enum values for `CustomerPaymentMethodRevocationReason`](https://shopify.dev/changelog/add-new-customerpaymentmethodrevocationreasons) Added new enum values to `CustomerPaymentMethodRevocationReason`: `CUSTOMER_REDACTED`, `TOO_MANY_CONSECUTIVE_FAILURES`, `CVV_ATTEMPTS_LIMIT_EXCEEDED` [Read full post –>](https://shopify.dev/changelog/add-new-customerpaymentmethodrevocationreasons) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [`productSet` and `customerSet` mutations now support upserts and custom IDs](https://shopify.dev/changelog/productset-and-customerset-mutations-now-support-upserts) As of API version 2025-04 of the GraphQL Admin API, the `productSet` and `customerSet` mutations can upsert by `identifier`, simplifying record management. [Read full post –>](https://shopify.dev/changelog/productset-and-customerset-mutations-now-support-upserts) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [New enum values for `FulfillmentOrderRejectionReason`](https://shopify.dev/changelog/new-enum-values-for-fulfillmentorderrejectionreason) We've added new `FulfillmentOrderRejectionReason` enum values for more detailed error messages. [Read full post –>](https://shopify.dev/changelog/new-enum-values-for-fulfillmentorderrejectionreason) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Combined Listings Update Mutation Enhancements](https://shopify.dev/changelog/combined-listings-update-mutation-enhancements) As of Admin API 2025-05, we have introduced new error codes that will be returned from the `combinedListingUpdate` mutation. These new errors are to provide more clarity when the mutation is called... [Read full post –>](https://shopify.dev/changelog/combined-listings-update-mutation-enhancements) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [View gift card maximum values](https://shopify.dev/changelog/view-gift-card-maximum-values) Use the `giftCardConfiguration` query to retrieve the maximum values for purchased and issued gift cards. [Read full post –>](https://shopify.dev/changelog/view-gift-card-maximum-values) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [New filter options added to `pages`, `articles`, and `comments` queries](https://shopify.dev/changelog/new-filter-options-added-to-pages-articles-and-comments) `articles`, `pages`, and `comments` queries now have full filter parity with the REST Admin API [Read full post –>](https://shopify.dev/changelog/new-filter-options-added-to-pages-articles-and-comments) * April 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [New `articleAuthors` query in the GraphQL Admin API](https://shopify.dev/changelog/new-articleauthors-query-in-the-graphql-admin-api) To fetch a list of article authors for a store, use the new `articleAuthors` query. [Read full post –>](https://shopify.dev/changelog/new-articleauthors-query-in-the-graphql-admin-api) * March 17, 2025 Tags: * Admin GraphQL API * 2025-04 ### [New `include_mirrored_exchanges` query filter parameter](https://shopify.dev/changelog/new-includemirroredexchanges-query-filter-parameter) API version 2025-04 introduces the `include_mirrored_exchanges` query filter parameter, which provides greater flexibility in managing and viewing exchange data. [Read full post –>](https://shopify.dev/changelog/new-includemirroredexchanges-query-filter-parameter) * March 17, 2025 Tags: * Action Required * Admin GraphQL API * 2025-04 ### [Deprecating PriceListUserErrorCode values](https://shopify.dev/changelog/deprecating-pricelistusererrorcode-values) Starting from 2025-04, unused `PriceListErrorCode` values will be removed. [Read full post –>](https://shopify.dev/changelog/deprecating-pricelistusererrorcode-values) * February 26, 2025 Tags: * Admin GraphQL API * 2025-04 ### [New customer address capabilities in the Admin API](https://shopify.dev/changelog/new-customer-address-capabilities-in-the-admin-api) 2025-04 adds `customerAddressCreate`, `customerAddressUpdate`, and `customerAddressDelete` mutations for more granular control on customer addresses. [Read full post –>](https://shopify.dev/changelog/new-customer-address-capabilities-in-the-admin-api) * February 24, 2025 Tags: * Admin GraphQL API * 2025-04 ### [The `X-Shopify-API-Deprecated-Reason` HTTP header will return actual GraphQL deprecations if any](https://shopify.dev/changelog/graphql-return-actual-deprecation-reasons) As of `2025-04`, the `X-Shopify-API-Deprecated-Reason` HTTP header will return the list of detected deprecations instead of a generic URL. [Read full post –>](https://shopify.dev/changelog/graphql-return-actual-deprecation-reasons) * February 19, 2025 Tags: * Admin GraphQL API * Admin REST API * Customer Account API * 2025-04 ### [Reserved prefix protection for metafields and metaobjects](https://shopify.dev/changelog/reserved-prefix-protection-for-metafields-and-metaobjects) New metafield namespaces and metaobject types can not have prefixes that end with double hyphens (e.g., "foo--"). Existing definitions remain unaffected. [Read full post –>](https://shopify.dev/changelog/reserved-prefix-protection-for-metafields-and-metaobjects) * February 17, 2025 Tags: * Admin GraphQL API * 2025-04 ### [New ends\_at, created\_at, and updated\_at query filter parameters for searching discounts](https://shopify.dev/changelog/new-endsat-createdat-and-updatedat-query-filter-parameters-for-searching-discounts) API version 2025-04 introduces the `ends_at`, `created_at`, and `updated_at` query filter parameters, which provides greater flexibility in managing and viewing discounts. [Read full post –>](https://shopify.dev/changelog/new-endsat-createdat-and-updatedat-query-filter-parameters-for-searching-discounts) * February 15, 2025 Tags: * Admin GraphQL API * 2025-04 ### [`NON_TEST_ORDER_LIMIT_REACHED` error code for subscriptions billing attempts](https://shopify.dev/changelog/nontestorderlimitreached-error-for-subscriptions-billing-attempts) Adds `NonTestOrderLimitReached` field to `SubscriptionBillingAttemptErrorCode`, alerting you when you've exceeded the order limit for a payment processor. [Read full post –>](https://shopify.dev/changelog/nontestorderlimitreached-error-for-subscriptions-billing-attempts) * February 14, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Updated Country Harmonized System Code validations on Product Variant mutations](https://shopify.dev/changelog/updated-country-harmonized-system-code-validations-on-product-variant-mutations) As of `2025-04`, Product Variant mutations will validate country harmonized system codes against existing inventory item harmonized system codes. [Read full post –>](https://shopify.dev/changelog/updated-country-harmonized-system-code-validations-on-product-variant-mutations) * February 5, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Attribute Marketing Consent to Retail Locations](https://shopify.dev/changelog/track-the-retail-locations-where-your-customers-update-their-marketing-consent) Use the GraphQL Admin API to query the retail location where customers are updating their marketing consent. [Read full post –>](https://shopify.dev/changelog/track-the-retail-locations-where-your-customers-update-their-marketing-consent) * February 1, 2025 Tags: * Admin GraphQL API * Customer Account API * 2025-04 ### [Removing unnecessary `RELEVANCE` sort options](https://shopify.dev/changelog/removing-unnecessary-relevance-sort-options) `RELEVANCE` will no longer be included in connection sort options by default as of `2025-04`. This will eliminate cases where the option offered no unique behavior. [Read full post –>](https://shopify.dev/changelog/removing-unnecessary-relevance-sort-options) * January 31, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Record partial payments on Orders](https://shopify.dev/changelog/record-partial-payments-on-orders) As of `2025-04` partial payments can be recorded on orders using the new [orderCreateManualPayment](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/orderCreateManualPayment) mutation.... [Read full post –>](https://shopify.dev/changelog/record-partial-payments-on-orders) * January 29, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Payout statuses In Transit and Scheduled have been merged](https://shopify.dev/changelog/payout-statuses-in-transit-and-scheduled-have-been-merged) Payout statuses "In Transit" and "Scheduled" are now merged as "Scheduled." Update workflows to recognize "Scheduled" for accurate payout info. Change is effective immediately. [Read full post –>](https://shopify.dev/changelog/payout-statuses-in-transit-and-scheduled-have-been-merged) * January 29, 2025 Tags: * Action Required * Admin GraphQL API * 2025-04 ### [New Catalog APIs](https://shopify.dev/changelog/new-catalog-apis) Catalog APIs now support multiple markets per catalog. Use `type: REGION` to maintain single market behavior. [Read full post –>](https://shopify.dev/changelog/new-catalog-apis) * January 25, 2025 Tags: * Admin GraphQL API * Customer Account API * 2025-04 ### [New creation, update, and status filters for subscriptionContracts](https://shopify.dev/changelog/subscription-contracts-filters) API v2025-04 now supports filtering subscriptionContracts by `created_at`, `updated_at`, and `status` in admin and customer APIs. [Read full post –>](https://shopify.dev/changelog/subscription-contracts-filters) * January 23, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Optional `role` argument for `themeCreate` mutation](https://shopify.dev/changelog/optional-role-argument-for-theme-create-mutation) The `themeCreate` mutation now supports an optional `role` argument. [Read full post –>](https://shopify.dev/changelog/optional-role-argument-for-theme-create-mutation) * January 15, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Expose the id field in ProductFullSyncPayload object](https://shopify.dev/changelog/expose-the-id-field-in-productfullsyncpayload-object) Version 2025-04: Admin API now includes the return field id in product full sync payload, enhancing data tracking for developers. [Read full post –>](https://shopify.dev/changelog/expose-the-id-field-in-productfullsyncpayload-object) * January 15, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Line item weight input for `orderCreate` mutation](https://shopify.dev/changelog/line-item-weight-input-for-ordercreate-mutation) The `orderCreate` mutation now supports `OrderCreateLineItemInput.weight` to set line item weights. [Read full post –>](https://shopify.dev/changelog/line-item-weight-input-for-ordercreate-mutation) * January 10, 2025 Tags: * Admin GraphQL API * 2025-04 ### [New card brands for OrderTransactions.paymentMethods](https://shopify.dev/changelog/new-card-brands-for-ordertransactionspaymentmethods) `OrderTransactions.paymentMethods` now includes `CARTES_BANCAIRES` and `BANCONTACT`. From API version 2025-04, transactions using these methods will show updated values in responses. [Read full post –>](https://shopify.dev/changelog/new-card-brands-for-ordertransactionspaymentmethods) * January 3, 2025 Tags: * Action Required * Admin GraphQL API * 2025-04 ### [New Markets APIs](https://shopify.dev/changelog/new-markets-apis) Markets APIs update: Use `backupRegionUpdate` for shop-wide regions, `BackupRegionUpdateInput` replaces `MarketRegionCreateInput`. `Market.currencySettings` is nullable. `WebPresence` replaces `MarketWebPresence`. [Read full post –>](https://shopify.dev/changelog/new-markets-apis) * January 1, 2025 Tags: * Admin GraphQL API * 2025-04 ### [Add new requiresShippingMethod field to fulfillmentServiceCreate and fulfillmentServiceUpdate mutations](https://shopify.dev/changelog/add-new-requiresshippingmethod-field-to-fulfillmentservicecreate-and-fulfillmentserviceupdate-mutations) As of Admin API 2025-04, we have introduced a new field `requiresShippingMethod` on the... [Read full post –>](https://shopify.dev/changelog/add-new-requiresshippingmethod-field-to-fulfillmentservicecreate-and-fulfillmentserviceupdate-mutations) * December 12, 2024 Tags: * Action Required * Admin GraphQL API * 2025-04 ### [Deprecation Notice: CalculatedOrder for committed order edits](https://shopify.dev/changelog/deprecation-notice-calculatedorder-for-committed-order-edits) We are deprecating the [`CalculatedOrder`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CalculatedOrder) object for committed order edits. There are no changes to `CalculatedOrder`... [Read full post –>](https://shopify.dev/changelog/deprecation-notice-calculatedorder-for-committed-order-edits)