--- 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: * 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 ### [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: * 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: * 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) * 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) * 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) * February 7, 2025 Tags: * Customer Account API * 2025-04 ### [New `event` and `origin` fields for store credit transactions](https://shopify.dev/changelog/new-event-and-origin-fields-for-store-credit-transactions) New fields `event` and `origin` added to store credit transactions for Customer Account GraphQL API `2025-04`. [Read full post –>](https://shopify.dev/changelog/new-event-and-origin-fields-for-store-credit-transactions) * 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)