Developer changelog

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.

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

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.

As of version 2025-04 of the GraphQL Storefront API, the Cart object includes a payment field that indicates whether a payment has been added. Additionally, it is possible to determine the type...

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.

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.

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.

The DigitalWallets enum now includes AMAZON_PAY, enabling its use in Storefront and Admin GraphQL APIs which can determine if Amazon Pay is available to buyers and has been used in transactions.

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

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

The description field for metafields is being removed in unstable.

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.

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

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.

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

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

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

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

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

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.

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

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.

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

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

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

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.

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

The themeCreate mutation now supports an optional role argument.

Updated InventoryItemInput and InventoryItem scopes allow updates with write_products and queries with read_products. Restrictions on inventoryLevel and location queries remain. Applies to all API versions.

Support added for $app namespaces in product queries by metafield which improves query flexibility.

Enable continuous authentication by appending customerAccessToken to cart in buyerIdentity. Authenticated checkouts now available for all plans.

The orderCreate mutation now supports OrderCreateLineItemInput.weight to set line item weights.

Version 2025-04: Admin API now includes the return field id in product full sync payload, enhancing data tracking for developers.

The GraphQL Admin API now includes the inventoryItem field in ProductVariantSetInput, effective from API version 2024-10, enhancing product management capabilities.

OrderTransactions.paymentMethods now includes CARTES_BANCAIRES and BANCONTACT. From API version 2025-04, transactions using these methods will show updated values in responses.

As of 2025-01, Function APIs validate input query variables. Invalid metafields now trigger InvalidVariableValueError, improving error detection and debugging for developers.

Use the new localizedFields in the Checkout Extensions APIs to apply custom validation for tax fields. The localizationExtensions field in the Admin API has now been renamed to localizedFields.

As of January 20, we added the following updates to POS UI Extensions:

Breaking Changes

• Removed the deprecated ActionItem component. Use a...

Markets APIs update: Use backupRegionUpdate for shop-wide regions, BackupRegionUpdateInput replaces MarketRegionCreateInput. Market.currencySettings is nullable. WebPresence replaces MarketWebPresence.

The 2024-10 GraphQL Admin API update adds collection_id as a filter in the products query, usable with specific filters like created_at, status, and vendor.

We introduced two new fields that allow you to accurately nest component products under the parent product in a grouped view.