Developer changelog

As of 2026-04, The fulfillmentOrderCancel mutation returns fulfillmentOrderCancelError with a code field, aiding developers in handling restrictions on in-progress fulfillment order cancellations.

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.

For some countries, cash transactions in POS now round to the nearest denomination. API versions 2024-10 and later now contain fields for order and transaction-level cash rounding adjustments.

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

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

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

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

As of Admin API 2025-05, we have introduced new error codes that will be returned from the combinedListingUpdate mutation. These new errors are to provide more clarity when the mutation is called...

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

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

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

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

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.

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.

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.

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.

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.

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 Transfers and Shipment APIs enable seamless integration with IMS/ERP, allowing full transfer management. Currently in "Unstable" stage, expected release candidate by July 2025.

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.

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.

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

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.

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.

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

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.

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.

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.

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