Developer changelog

Cart mutations now return a MERCHANDISE NOT APPLICABLE error for invalid merchandise configurations.

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.

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.

Starting July 2025, third-party apps can self-uninstall via a new GraphQL mutation.

DigitalWallet enum now supports Amazon Pay and Facebook Pay, enhancing storefront and GraphQL API visibility for these payment methods, and impacting merchant transaction tracking.

Order status URLs now use capability tokens instead of static keys, improving security with limited uses and automatic expiration. Optional parameters available for customization.

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.

App subscription plans now include persistent plan handles, making it easier to query for plan data.

API version 2025-04 lets you manage shop privacy settings, including cookie banners, data sale opt-outs, and privacy policy automation.

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...

Use this webhook to learn when your users have upgraded their Thank you and Order status pages.

The Payments Apps API now supports AVS and CVV details for card-not-present transactions.

Use the giftCardConfiguration query to retrieve the maximum values for purchased and issued gift cards.

Developer Preview: Serve your app on localhost with a self-signed HTTPS certificate using Shopify CLI.

articles, pages, and comments queries now have full filter parity with the REST Admin API

To fetch a list of article authors for a store, use the new articleAuthors query.

API v2025-04 adds fulfillmentStatus to Order, showing the order's overall fulfillment status for display.

Shopify.dev MCP Server released! It lets AI assistants access Shopify docs and API schemas, enhancing development within Cursor or Claude desktop.

Webhook scopes for InventoryItem are now flexible, allowing read_inventory or read_products for INVENTORY_ITEMS_CREATE, DELETE, UPDATE across all API versions.

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.

Added new input fields for card-not-present transactions: avsResultCode for AVS response and cvvResultCode for CVV verification. Enhances payment processing details.

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.

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.

Hydrogen v2025.1.3 adds support for Vite 6 and enables the v3_routeConfig future flag for Remix.

How Retail Ship and carry out orders will impact the behaviour of order and fulfillment order objects

Apps will see an improved visual appearance of the App Bridge Title Bar API starting to rollout, to match the new...

Liquid now supports OKLCH colors, enabling a broader color range. New features include color_to_oklch filter and enhanced color object properties for OKLCH.

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.

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.

The 2025-04 Admin API allows custom identifier lookup for collections, locations, orders, and product variants.

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.

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.

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.

Starting from 2025-04, unused PriceListErrorCode values will be removed.

JS Buy SDK v3.0 is now available

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...

New Shopify Collective docs offer guidance on integrating systems using Shopify's API and webhooks, enhancing workflow integration for developers.

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.

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...

As of the 2025-04 API version, the OrderEditAddVariant API will adhere to the pricing configurations set for Markets and Company Locations.

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.

Introducing the .dev Assistant extension for VSCode, enhancing your development workflow directly in the editor for improved efficiency.

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.

All impacted apps need to update to the Storefront Cart API before April 1, 2025 to avoid disruptions.

The description field for metafields is being removed in unstable.

2025-04 adds customerAddressCreate, customerAddressUpdate, and customerAddressDelete mutations for more granular control on customer addresses.

As of 2025-04, the X-Shopify-API-Deprecated-Reason HTTP header will return the list of detected deprecations instead of a generic URL.

New metafield namespaces and metaobject types can not have prefixes that end with double hyphens (e.g., "foo--"). Existing definitions remain unaffected.

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.

Explicit grants for app-owned metafields end on Feb 24, 2025. Use custom namespace for sharing metafields between apps after this date.