--- 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?action_required=true&page=2 md: https://shopify.dev/changelog.md?action_required=true&page=2 --- # 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) * January 1, 2025 Tags: * Action Required * Storefront GraphQL API * 2025-01 ### [Cart Delivery Address Management](https://shopify.dev/changelog/cart-delivery-address-management) API v2025-01 deprecates `buyerIdentity.deliveryAddressPreferences`, replacing it with `cart.delivery.addresses`. Manage addresses using new mutations. [Read full post –>](https://shopify.dev/changelog/cart-delivery-address-management) * January 1, 2025 Tags: * Action Required * Webhook * 2025-01 ### [New customer's webhook and changes to existing customer's webhooks payload](https://shopify.dev/changelog/new-customer-s-webhook-and-changes-to-existing-customer-s-webhooks-payload) As of 2025-01, customer webhooks updated: new `customers/purchasing_summary` added, `tags` and consent fields replaced, and some fields moved to the new webhook. [Read full post –>](https://shopify.dev/changelog/new-customer-s-webhook-and-changes-to-existing-customer-s-webhooks-payload) * January 1, 2025 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Fulfillment Hold Access Update For Node Queries](https://shopify.dev/changelog/fulfillment-hold-access-update-for-node-queries) Admin API 2025-01 restricts fulfillment hold access via node queries based on app scopes. Ensure correct scopes to avoid null results when fetching holds. [Read full post –>](https://shopify.dev/changelog/fulfillment-hold-access-update-for-node-queries) * December 30, 2024 Tags: * Action Required * Shopify App Store ### [Updates effective December 30 to our Partner Program Agreement and API License and Terms of Use](https://shopify.dev/changelog/updates-effective-december-30-to-our-partner-program-agreement-and-api-license-and-terms-of-use) Review updated Partner Program and API Terms effective Dec 30, 2024. Theme Revenue Share changes Jan 1, 2025. Ensure compliance to support app growth and security. [Read full post –>](https://shopify.dev/changelog/updates-effective-december-30-to-our-partner-program-agreement-and-api-license-and-terms-of-use) * 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) * December 19, 2024 Tags: * Action Required * Shopify App Store ### [Updated requirement: Draft apps must not make calls to APIs that will be deprecated in 90 days or less](https://shopify.dev/changelog/updated-requirement-draft-apps-must-not-make-calls-to-apis-that-will-be-deprecated-in-90-days-or-less) Starting January 6, 2025, draft apps that make calls to APIs that will be deprecated in 90 days or less will not be able to submit their apps for review. This is an updated requirement. Be sure to... [Read full post –>](https://shopify.dev/changelog/updated-requirement-draft-apps-must-not-make-calls-to-apis-that-will-be-deprecated-in-90-days-or-less) * December 17, 2024 Tags: * Action Required * Shopify App Store ### [Session tokens and app listings automatically checked before submitting for app review](https://shopify.dev/changelog/session-tokens-and-app-listings-automatically-checked-before-submitting-for-app-review) Starting January 6, 2025, we are introducing additional preliminary steps in the app review process. These steps will provide immediate compliance feedback on draft apps before they are submitted... [Read full post –>](https://shopify.dev/changelog/session-tokens-and-app-listings-automatically-checked-before-submitting-for-app-review) * December 13, 2024 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Changes to ScriptTag displayScope field on Admin GraphQL API](https://shopify.dev/changelog/changes-to-scripttag-displayscope-field-on-admin-graphql-api) Using Script Tags? Start ensuring you're targeting the ONLINE\_STORE as the `displayScope`. [Read full post –>](https://shopify.dev/changelog/changes-to-scripttag-displayscope-field-on-admin-graphql-api) * December 12, 2024 Tags: * Action Required * API * 2025-01 ### [Product image resource in REST now returns a media image GID to streamline migration to GraphQL](https://shopify.dev/changelog/product-image-resource-in-rest-now-returns-a-media-image-gid-to-streamline-migration-to-graphql) From 2025-01, the admin REST API returns a media image GID, aiding migration to GraphQL. Only affects 2025-01 API users; older versions remain unchanged. Upgrade to GraphQL recommended. [Read full post –>](https://shopify.dev/changelog/product-image-resource-in-rest-now-returns-a-media-image-gid-to-streamline-migration-to-graphql) * 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) * December 11, 2024 Tags: * Action Required * Built for Shopify ### [Built for Shopify Requirements for embedded apps and apps in marketing categories](https://shopify.dev/changelog/built-for-shopify-requirements-for-embedded-apps-and-apps-in-marketing-categories-effective-july-2025) New Built for Shopify requirements for apps to achieve or maintain status in 2025 [Read full post –>](https://shopify.dev/changelog/built-for-shopify-requirements-for-embedded-apps-and-apps-in-marketing-categories-effective-july-2025) * December 10, 2024 Tags: * Action Required * Admin GraphQL API * Liquid * 2025-01 ### [Simplifying how metafield and metaobject permissions work](https://shopify.dev/changelog/simplifying-how-metafield-and-metaobject-permissions-work) In the new year we’re simplifying how metafield and metaobject permissions work. This makes the system easier to work with and will further improve API response times. In summary: * On \*\*Jan... [Read full post –>](https://shopify.dev/changelog/simplifying-how-metafield-and-metaobject-permissions-work) * December 5, 2024 Tags: * Action Required * Shopify App Store ### [App extensions can’t be used for self-promotion or related activities](https://shopify.dev/changelog/app-extensions-can-t-be-used-for-self-promotion-or-related-activities) Starting December 5, 2024, app extensions, including admin links, checkout extensibility, and theme app extensions can’t be used to advertise your app, promote related apps, or request reviews. [Read full post –>](https://shopify.dev/changelog/app-extensions-can-t-be-used-for-self-promotion-or-related-activities) * December 5, 2024 Tags: * Action Required * Admin GraphQL API * Webhook * 2025-01 ### [PrivateMetafield is now deprecated](https://shopify.dev/changelog/privatemetafield-is-now-deprecated) Starting in API version **2025-01**, PrivateMetafield will be removed from the GraphQL Admin API. Use \](https://shopify.dev/changelog/privatemetafield-is-now-deprecated) * December 3, 2024 Tags: * Action Required * API ### [JS Buy SDK Deprecation Notice](https://shopify.dev/changelog/js-buy-sdk-deprecation-notice) The JS Buy SDK is deprecated by Jan 2025. Switch to Storefront API Client or upgrade to JS Buy SDK v3.0 by July 1, 2025, to ensure continued functionality and purchase capability. [Read full post –>](https://shopify.dev/changelog/js-buy-sdk-deprecation-notice) * November 12, 2024 Tags: * Action Required * API * 2025-01 ### [Conditionally disable gift cards in checkout using custom logic with the Payment Customization API](https://shopify.dev/changelog/conditionally-disable-gift-cards-in-checkout-using-custom-logic-with-the-payment-customization-api) As of Nov 12, 2024, the Payment Customization API allows disabling gift card features, hiding fields, and removing applied cards. Available in unstable and stable 2025-01 API versions. [Read full post –>](https://shopify.dev/changelog/conditionally-disable-gift-cards-in-checkout-using-custom-logic-with-the-payment-customization-api) * November 12, 2024 Tags: * Action Required * Themes ### [Changes to our Font Library](https://shopify.dev/changelog/changes-to-our-font-library) Shopify has deprecated some fonts and added 32 new open-source typefaces. Theme developers must replace deprecated fonts by Jan 3, 2025, using recommended or available alternatives. [Read full post –>](https://shopify.dev/changelog/changes-to-our-font-library) * November 6, 2024 Tags: * Action Required * POS Extensions ### [POS Legacy Extensions Will Be Deprecated in February 2025](https://shopify.dev/changelog/pos-legacy-extensions-will-be-deprecated-in-february-2025) On Feb 28, 2025, Shopify POS will deprecate POS Links, cart app, and product recommendation extensions. Rebuild using POS UI Extensions for enhanced capabilities. [Read full post –>](https://shopify.dev/changelog/pos-legacy-extensions-will-be-deprecated-in-february-2025) * November 5, 2024 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Remove `metafieldDelete` in favor of `metafieldsDelete`](https://shopify.dev/changelog/remove-metafielddelete-in-favor-of-metafieldsdelete) As of `2025-01` the `metafieldDelete` Admin API method is being removed. The `metafieldsDelete` method should be used instead. The former relies on the Metafield GID, while the latter takes an... [Read full post –>](https://shopify.dev/changelog/remove-metafielddelete-in-favor-of-metafieldsdelete) * November 1, 2024 Tags: * Action Required * Admin GraphQL API * Customer Account API * Payments Apps API * 2025-01 ### [Content type `application/graphql` is deprecated](https://shopify.dev/changelog/content-type-application-graphql-is-deprecated) The `Content-Type: application/graphql` request format is deprecated and will no longer be accepted as of 2025-01 schema versions. As of `2025-01` schemas, all requests must specify \`Content-Type:... [Read full post –>](https://shopify.dev/changelog/content-type-application-graphql-is-deprecated) * November 1, 2024 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Removing `multiLocation` field from `ShopFeatures`](https://shopify.dev/changelog/removing-multilocation-field-from-shopfeatures) As of the **2025-01** release of the Admin GraphQL API, the deprecated `multiLocation` field on [ShopFeatures](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopFeatures) will be... [Read full post –>](https://shopify.dev/changelog/removing-multilocation-field-from-shopfeatures) * October 28, 2024 Tags: * Action Required * Themes ### [Change to metafield type handling in liquid](https://shopify.dev/changelog/change-to-metafield-type-handling-in-liquid) Metafields without a `type` now default to "string" instead of `blank`. Update your checks to ensure compatibility with this change. [Read full post –>](https://shopify.dev/changelog/change-to-metafield-type-handling-in-liquid) * October 28, 2024 Tags: * Action Required * Themes * Liquid ### [Updates to Theme Information Access in Shopify](https://shopify.dev/changelog/updates-to-theme-information-access-in-shopify) Transition from BOOMR to `window.Shopify.theme` for theme data by 31/01/2025. Use `schema_name` and `schema_version` for reliable theme info. BOOMR support ends on this date. [Read full post –>](https://shopify.dev/changelog/updates-to-theme-information-access-in-shopify) * October 28, 2024 Tags: * Action Required * Platform ### [Breaking Changes to CAPTCHA protection on Storefront forms](https://shopify.dev/changelog/breaking-changes-to-captcha-protection-on-storefront-forms) Starting 28th Oct 2024, hCaptcha is required for login, account creation, and password reset forms. reCAPTCHA is deprecated; update custom code to avoid 400 errors. [Read full post –>](https://shopify.dev/changelog/breaking-changes-to-captcha-protection-on-storefront-forms) * October 24, 2024 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Update to `fulfillmentHold.heldByApp` field from `fulfillmentHold.heldBy` field](https://shopify.dev/changelog/update-to-fulfillmenthold-heldbyapp-field-from-fulfillmenthold-heldby-field) In API version 2025-01, `heldBy` is replaced by `heldByApp` in `fulfillmentHold`. Update queries to `fulfillmentHold.heldByApp.title` for full app details. [Read full post –>](https://shopify.dev/changelog/update-to-fulfillmenthold-heldbyapp-field-from-fulfillmenthold-heldby-field) * October 15, 2024 Tags: * Action Required * Shopify App Store ### [Shopify App Store apps require the latest App Bridge](https://shopify.dev/changelog/shopify-app-store-apps-require-the-latest-app-bridge) Starting October 15th, 2025, all Shopify App Store apps that appear in the Shopify admin must use the [latest Shopify App Bridge](https://shopify.dev/docs/api/app-bridge-library#getting-started) by... [Read full post –>](https://shopify.dev/changelog/shopify-app-store-apps-require-the-latest-app-bridge) [Previous](https://shopify.dev/changelog?action_required=true\&page=1)