Developer changelog

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.

Webhook GraphQL mutations now support a uri field for all address types, deprecating specific endpoint mutations. webhookSubscriptions query adds uri filtering; callbackUrl is deprecated.

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

Line items can now be split across multiple fulfillment locations, preventing overselling and improving inventory accuracy.

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

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

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

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

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.

API version 2025-04 introduces the include_mirrored_exchanges query filter parameter, which provides greater flexibility in managing and viewing exchange data.

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

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.

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.

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

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

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.

Hydrogen v2025.1.1 validated Remix v3_singleFetch future flag, stabilized B2B methods and props and several package version updates.

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

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.

Adds NonTestOrderLimitReached field to SubscriptionBillingAttemptErrorCode, alerting you when you've exceeded the order limit for a payment processor.

As of 2025-04, Product Variant mutations will validate country harmonized system codes against existing inventory item harmonized system codes.

New Liquid filters find, find_index, has, and reject simplify array handling by eliminating verbose loops and complex logic, making your code more concise and declarative

Revamped our Discounts GraphQL Admin API docs with more detailed descriptions and real-world examples, based on your user feedback!

app deploy now instantly deploys Flow template extensions. After a post-deploy review, approved templates appear in the library; unapproved ones receive feedback for changes before redeployment.

New fields event and origin added to store credit transactions for Customer Account GraphQL API 2025-04.

Use the GraphQL Admin API to query the retail location where customers are updating their marketing consent.

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.

Hydrogen v2025.1.0 adds Storefront API 2025-01 support, validated Remix v3_lazyRouteDiscovery future flag and several bug fixes. Deprecated features removed for improved performance.

As of 2025-04 partial payments can be recorded on orders using the new orderCreateManualPayment mutation....

Payout statuses "In Transit" and "Scheduled" are now merged as "Scheduled." Update workflows to recognize "Scheduled" for accurate payout info. Change is effective immediately.

Catalog APIs now support multiple markets per catalog. Use type: REGION to maintain single market behavior.

Access metaobjects in Liquid using metaobjects.type.handle for standardization. The old shop.metaobjects.type.handle is deprecated but still supported. Transition to the new syntax.

API v2025-04 now supports filtering subscriptionContracts by created_at, updated_at, and status in admin and customer APIs.

Starting February 1, 2025, all apps submitted to the Shopify App Store will be checked for scopes that require Shopify permission for approved use cases.

Apps that have unnecessary scopes, or...

The themeCreate mutation now supports an optional role argument.

Admin API 2025-01 adds 'event' and 'origin' fields to store credit transactions, enhancing traceability and auditing for better financial reporting and customer service.