--- 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_version=2025-04 md: https://shopify.dev/changelog.md?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: * Webhook * 2025-04 ### [New webhook to track updates to checkout and accounts configuration](https://shopify.dev/changelog/new-webhook-to-track-updates-to-checkout-and-accounts-configuration) Use this webhook to learn when your users have upgraded their Thank you and Order status pages. [Read full post –>](https://shopify.dev/changelog/new-webhook-to-track-updates-to-checkout-and-accounts-configuration) * 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: * Customer Account API * 2025-04 ### [`@inContext` directive added to the Customer Account API](https://shopify.dev/changelog/exposed-incontext-directive-with-the-customer-account-api) `@inContext` directive added to the 2025-04 version of the Customer Account API to help integrate with international markets [Read full post –>](https://shopify.dev/changelog/exposed-incontext-directive-with-the-customer-account-api) * April 1, 2025 Tags: * API * 2025-04 ### [Checkout UI extensions: Attributes API now supports removing cart and checkout attributes](https://shopify.dev/changelog/checkout-ui-extensions-attributes-api-now-supports-removing-cart-and-checkout-attributes) You can now remove cart and checkout attributes by passing the attribute key you wish to remove with the AttributeRemoveChange property. [Read full post –>](https://shopify.dev/changelog/checkout-ui-extensions-attributes-api-now-supports-removing-cart-and-checkout-attributes) * 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 * 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 ### [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 * 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 `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 ### [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: * Customer Account API * 2025-04 ### [New field `fulfillmentStatus` added to the `Order` type of the Customer Account API](https://shopify.dev/changelog/new-field-fulfillmentstatus-added-to-the-order-type-of-the-customer-account-api) API v2025-04 adds `fulfillmentStatus` to `Order`, showing the order's overall fulfillment status for display. [Read full post –>](https://shopify.dev/changelog/new-field-fulfillmentstatus-added-to-the-order-type-of-the-customer-account-api) * 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 31, 2025 Tags: * Payments Apps API * 2025-04 ### [Expose payment detail fields for Payments Apps API](https://shopify.dev/changelog/expose-payment-detail-fields-for-payments-apps) Added new input fields for card-not-present transactions: avsResultCode for AVS response and cvvResultCode for CVV verification. Enhances payment processing details. [Read full post –>](https://shopify.dev/changelog/expose-payment-detail-fields-for-payments-apps) * March 28, 2025 Tags: * POS Extensions * 2025-04 ### [POS UI Extensions 2025-04 Update](https://shopify.dev/changelog/pos-ui-extensions-2025-04-update) Renamed NewTextFieldProps to TextFieldProps. Added support for transaction complete, cash tracking, and receipt footer targets. Introduced POSReceiptBlock component for receipt footer. [Read full post –>](https://shopify.dev/changelog/pos-ui-extensions-2025-04-update) * March 22, 2025 Tags: * API * 2025-04 ### [Using custom ids to look up collections, locations, orders, and product variants](https://shopify.dev/changelog/custom-ids-more-lookups) The 2025-04 Admin API allows custom identifier lookup for collections, locations, orders, and product variants. [Read full post –>](https://shopify.dev/changelog/custom-ids-more-lookups) * 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) * March 7, 2025 Tags: * Customer Accounts * 2025-04 ### [Support added for app-owned metafields](https://shopify.dev/changelog/support-added-for-app-owned-metafields-in-checkout-ui-extension-api) The 2025-04 API version for Checkout and Customer Account UI extensions allows reading app owned metafields via `appMetafield` API. Configure by applying the `$app` format in the extension `toml`. [Read full post –>](https://shopify.dev/changelog/support-added-for-app-owned-metafields-in-checkout-ui-extension-api) * March 7, 2025 Tags: * Action Required * POS Extensions * 2025-04 ### [End of Compatibility for Old POS UI Extensions Versions](https://shopify.dev/changelog/end-of-compatibility-for-old-pos-ui-extensions-versions) Shopify API 2025.04 ends support for specific POS UI Extension versions. Update to the latest version to ensure functionality with POS 9.31 and beyond. [Read full post –>](https://shopify.dev/changelog/end-of-compatibility-for-old-pos-ui-extensions-versions) * March 2, 2025 Tags: * Action Required * Admin REST API * Storefront GraphQL API * 2025-04 ### [Checkout APIs will be shut down April 1, 2025](https://shopify.dev/changelog/checkout-apis-will-be-shut-down-april-1-2025) All impacted apps need to update to the Storefront Cart API before April 1, 2025 to avoid disruptions. [Read full post –>](https://shopify.dev/changelog/checkout-apis-will-be-shut-down-april-1-2025) * 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)