--- 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?itcat=partner_blog&itterm=storefront_api&page=6 md: https://shopify.dev/changelog.md?itcat=partner_blog&itterm=storefront_api&page=6 --- # 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) * August 29, 2025 Tags: * Storefront GraphQL API * 2025-10 ### [Cart mutations now return error for invalid merchandise configuration](https://shopify.dev/changelog/storefront-api-cart-now-exposes-invalid-merchandise-configuration-error) Cart mutations now return a `MERCHANDISE NOT APPLICABLE` error for invalid merchandise configurations. [Read full post –>](https://shopify.dev/changelog/storefront-api-cart-now-exposes-invalid-merchandise-configuration-error) * August 18, 2025 Tags: * Action Required * Admin GraphQL API * 2025-10 ### [Introducing the new `context` field to specify discount eligibility](https://shopify.dev/changelog/discount-eligibility-management) We’ve introduced a new context field to specify discount eligibility code and automatic discounts. The context field replaces the now deprecated DiscountCustomerSelection field for code discounts. [Read full post –>](https://shopify.dev/changelog/discount-eligibility-management) * July 18, 2025 Tags: * Storefront GraphQL API ### [Cart quantity limits are now determined by market region](https://shopify.dev/changelog/contextualized-inventory-availability-in-cart-updates) Cart quantity limits now depend on inventory available in the buyer's market region, not total stock. Exceeding this triggers an error and adjusts to available stock. [Read full post –>](https://shopify.dev/changelog/contextualized-inventory-availability-in-cart-updates) * 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) * June 4, 2025 Tags: * Admin GraphQL API * Storefront GraphQL API ### [`AMAZON_PAY` and `FACEBOOK_PAY` values enumerated in digital wallets](https://shopify.dev/changelog/amazonpay-and-facebookpay-enumerated-in-digitalwallets) DigitalWallet enum now supports Amazon Pay and Facebook Pay, enhancing storefront and GraphQL API visibility for these payment methods, and impacting merchant transaction tracking. [Read full post –>](https://shopify.dev/changelog/amazonpay-and-facebookpay-enumerated-in-digitalwallets) * April 22, 2025 Tags: * Action Required * Admin GraphQL API ### [New arguments added to `statusPageUrl` field on the `Order` object](https://shopify.dev/changelog/new-arguments-added-to-statuspageurl-field-on-order-object) Order status URLs now use capability tokens instead of static keys, improving security with limited uses and automatic expiration. Optional parameters available for customization. [Read full post –>](https://shopify.dev/changelog/new-arguments-added-to-statuspageurl-field-on-order-object) * April 14, 2025 Tags: * Payments Apps API * 2025-07 ### [Session creation payloads now include ISO 3166-2 province codes](https://shopify.dev/changelog/payment-session-payloads-now-include-iso-3166-2-province-codes) Payment session payloads now include ISO 3166-2 province codes (e.g., "QC") for consistent regional handling. Available in API v2025-07+. Existing apps remain unaffected. [Read full post –>](https://shopify.dev/changelog/payment-session-payloads-now-include-iso-3166-2-province-codes) * 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 * 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: * Payments Apps API * 2025-07 ### [Support for card not present transaction details in PaymentsApps API](https://shopify.dev/changelog/support-for-card-not-present-transaction-details-in-paymentsapps-api) The Payments Apps API now supports AVS and CVV details for card-not-present transactions. [Read full post –>](https://shopify.dev/changelog/support-for-card-not-present-transaction-details-in-paymentsapps-api) * 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: * Tools ### [Developer Preview: Localhost-based development for `shopify app dev`](https://shopify.dev/changelog/developer-preview-localhost-based-development-for-shopify-app-dev) Developer Preview: Serve your app on localhost with a self-signed HTTPS certificate using Shopify CLI. [Read full post –>](https://shopify.dev/changelog/developer-preview-localhost-based-development-for-shopify-app-dev) * 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: * Tools ### [Shopify.dev MCP Server](https://shopify.dev/changelog/mcp-server-for-the-shopify-dev-assistant) Shopify.dev MCP Server released! It lets AI assistants access Shopify docs and API schemas, enhancing development within Cursor or Claude desktop. [Read full post –>](https://shopify.dev/changelog/mcp-server-for-the-shopify-dev-assistant) * March 31, 2025 Tags: * Admin GraphQL API * Admin REST API ### [InventoryItem Webhooks Accessible with Product Scopes](https://shopify.dev/changelog/inventoryitem-webhooks-accessible-with-product-scopes) Webhook scopes for InventoryItem are now flexible, allowing `read_inventory` or `read_products` for `INVENTORY_ITEMS_CREATE`, `DELETE`, `UPDATE` across all API versions. [Read full post –>](https://shopify.dev/changelog/inventoryitem-webhooks-accessible-with-product-scopes) * March 31, 2025 Tags: * Storefront GraphQL API * 2025-07 ### [Storefront API Cart now exposes selling plan errors](https://shopify.dev/changelog/storefront-api-cart-exposes-selling-plan-errors) Version 2025-07 of the GraphQL Storefront API improves error handling for selling plans. Cart mutations now specify errors for missing or inapplicable selling plans. [Read full post –>](https://shopify.dev/changelog/storefront-api-cart-exposes-selling-plan-errors) * 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 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 31, 2025 Tags: * Admin GraphQL API ### [Location ID Queryable with Inventory Scopes](https://shopify.dev/changelog/location-id-queryable-with-inventory-scopes) `location.id` can now be queried with `read_inventory` or `read_locations` scopes. Other `Location` fields still need `read_locations`. Applies to all API versions. [Read full post –>](https://shopify.dev/changelog/location-id-queryable-with-inventory-scopes) * March 31, 2025 Tags: * Platform ### [Hydrogen March 2025 Release](https://shopify.dev/changelog/hydrogen-march-2025-release) Hydrogen v2025.1.3 adds support for Vite 6 and enables the `v3_routeConfig` future flag for Remix. [Read full post –>](https://shopify.dev/changelog/hydrogen-march-2025-release) * March 31, 2025 Tags: * Built for Shopify ### [Ship and carry out in a single order on POS is now available for Retail Pro Merchants using eligible tax software](https://shopify.dev/changelog/ship-carry-out-in-a-single-order-on-pos-is-now-available-for-retail-pro-merchants-using-eligible-tax-software) How Retail Ship and carry out orders will impact the behaviour of order and fulfillment order objects [Read full post –>](https://shopify.dev/changelog/ship-carry-out-in-a-single-order-on-pos-is-now-available-for-retail-pro-merchants-using-eligible-tax-software) * March 31, 2025 Tags: * Platform ### [App Bridge Title Bar visual update](https://shopify.dev/changelog/app-bridge-title-bar-visual-update) Apps will see an improved visual appearance of the [App Bridge Title Bar API](https://shopify.dev/docs/api/app-bridge-library/web-components/ui-title-bar) starting to rollout, to match the new\... [Read full post –>](https://shopify.dev/changelog/app-bridge-title-bar-visual-update) * March 27, 2025 Tags: * Themes ### [Liquid support for OKLCH colors](https://shopify.dev/changelog/liquid-support-for-oklch-colors) Liquid now supports OKLCH colors, enabling a broader color range. New features include `color_to_oklch` filter and enhanced `color` object properties for OKLCH. [Read full post –>](https://shopify.dev/changelog/liquid-support-for-oklch-colors) * March 26, 2025 Tags: * Admin GraphQL API * Admin REST API ### [Re-enabled customer search terms in the GraphQL and REST Admin APIs](https://shopify.dev/changelog/re-enabled-customer-search-terms) The GraphQL and REST Admin API now support various customer-related search terms that were disabled in API version 2024-07. For example: `accepts_marketing`, `city`, `company`, and more. [Read full post –>](https://shopify.dev/changelog/re-enabled-customer-search-terms) * March 24, 2025 Tags: * Admin GraphQL API ### [Draft Orders automatically purged after 1 year of inactivity](https://shopify.dev/changelog/draft-orders-automatically-purged-after-1-year-of-inactivity) Draft orders inactive for a year will auto-delete starting April 1, 2026 to improve data management and app performance. Applies to orders created after April 1, 2025. [Read full post –>](https://shopify.dev/changelog/draft-orders-automatically-purged-after-1-year-of-inactivity) * 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 21, 2025 Tags: * Admin GraphQL API ### [Retail Exchanges now use the Shopify Exchanges implementation](https://shopify.dev/changelog/retail-exchanges-now-use-the-shopify-exchanges-implementation) Shopify Exchange Platform now supports Retail Exchanges, consolidating operations into a single Return. Update integrations for unified sales agreements. ExchangeV2 APIs deprecated in 1 year. [Read full post –>](https://shopify.dev/changelog/retail-exchanges-now-use-the-shopify-exchanges-implementation) * March 19, 2025 Tags: * Shopify App Store ### [Ads are now available on mobile, plus more surfaces to target merchants](https://shopify.dev/changelog/ads-are-now-available-on-mobile-plus-more-surfaces-to-target-merchants) Shopify App Store now supports mobile ads and targeting on homepage and category page ads. Set bid prices for devices and access detailed mobile ad reports via Ads Manager in your Partner Dashboard. [Read full post –>](https://shopify.dev/changelog/ads-are-now-available-on-mobile-plus-more-surfaces-to-target-merchants) * 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) * 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 13, 2025 Tags: * Action Required * API ### [Now available: JS Buy SDK v3.0](https://shopify.dev/changelog/now-available-js-buy-sdk-v30) JS Buy SDK v3.0 is now available [Read full post –>](https://shopify.dev/changelog/now-available-js-buy-sdk-v30) * March 11, 2025 Tags: * Admin GraphQL API ### [Adding defaultPhoneNumber field to Customer](https://shopify.dev/changelog/adding-defaultphonenumber-field-to-customer) As of GraphQL Admin API version **2025-04**, the `defaultPhoneNumber` field is introduced on the `Customer` object to support querying a customer's phone number and marketing state. Learn more... [Read full post –>](https://shopify.dev/changelog/adding-defaultphonenumber-field-to-customer) * March 7, 2025 Tags: * API ### [New developer documentation now available for Shopify Collective](https://shopify.dev/changelog/shopify-collective-developer-documentation) New Shopify Collective docs offer guidance on integrating systems using Shopify's API and webhooks, enhancing workflow integration for developers. [Read full post –>](https://shopify.dev/changelog/shopify-collective-developer-documentation) * 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 6, 2025 Tags: * POS Extensions ### [POS UI Extensions: Modal update](https://shopify.dev/changelog/pos-ui-extensions-modal-update) In POS version 9.30, the POS UI Extensions modal will be enhanced to prevent accidental dismissals. You won't be able to dismiss the modal by swiping down or tapping outside of it. This update is... [Read full post –>](https://shopify.dev/changelog/pos-ui-extensions-modal-update) * March 4, 2025 Tags: * API ### [\[Cart AJAX API\] Inventory error message updates](https://shopify.dev/changelog/cart-ajax-api-inventory-error-message-updates) Updated AJAX API error messages for inventory requests: "Only available quantity added" and "Max quantity in cart." Affects `add.js`, `change.js`, and `update.js` endpoints. [Read full post –>](https://shopify.dev/changelog/cart-ajax-api-inventory-error-message-updates) * March 3, 2025 Tags: * Tools ### [Introducing the .dev Assistant VSCode Extension](https://shopify.dev/changelog/introducing-the-dev-assistant-vscode-extension) Introducing the .dev Assistant extension for VSCode, enhancing your development workflow directly in the editor for improved efficiency. [Read full post –>](https://shopify.dev/changelog/introducing-the-dev-assistant-vscode-extension) * March 3, 2025 Tags: * Admin GraphQL API ### [New GraphQL APIs for Inventory Transfers Management](https://shopify.dev/changelog/new-graphql-apis-for-inventory-transfers-management) New Transfers and Shipment APIs enable seamless integration with IMS/ERP, allowing full transfer management. Currently in "Unstable" stage, expected release candidate by July 2025. [Read full post –>](https://shopify.dev/changelog/new-graphql-apis-for-inventory-transfers-management) * 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 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) * 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 18, 2025 Tags: * Admin GraphQL API * Admin REST API * Webhook ### [No-op for unchanged metafields and metaobjects](https://shopify.dev/changelog/no-op-for-unchanged-metafields-and-metaobjects) Metafield/metaobject writes that don't change values won't trigger actions like webhooks, enhancing efficiency by reducing unnecessary processing in select mutations and bulk operations. [Read full post –>](https://shopify.dev/changelog/no-op-for-unchanged-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) [Previous](https://shopify.dev/changelog?itcat=partner_blog\&itterm=storefront_api\&page=5) [Next](https://shopify.dev/changelog?itcat=partner_blog\&itterm=storefront_api\&page=7)