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.

In version 2025-10, collectionReorderProducts mutation's userErrors type changes to CollectionReorderProductsUserError, adding a code field for enhanced error handling.

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

To clear all delivery addresses associated with a cart, call the cartDeliveryAddressesUpdate mutation and set addresses to an empty array.

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.

Added minRange and maxRange fields to segment filters in the Admin GraphQL API to expose valid value ranges for customer segmentation.

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

API version 2025-07 includes new fields to help you process returns

GraphQL now includes orderCustomerRemove and orderCustomerSet mutations and an Order.number field, so you can manage customers on orders programatically.

Product, Order, and Shipping Discount Function APIs are replaced by the new Discount Function API. Transition by API version 2026-04 in order to benefit from the new simplified and flexible API.

We’re introducing a new Discount Function API that enables merchants to apply a single discount that simultaneously affects products, order totals, and shipping costs.

For Enterprise merchants, Discount Functions now supports network access. This allows integration with external discount, loyalty, and promotion systems.

The release candidate for version 2025-07 of the Storefront, GraphQL Admin, and Customer Account APIs now support imperial units and count measurements, enabling more transparent pricing.

In the POS UI Extensions Cart API, some Customer fields have been removed from the subscribable hook. To get this data, developers can query the customer by customerId.

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

productSet mutation returns more precise PRODUCT_SUSPENDED error code

Automatically create smart collections with the new PRODUCT_CATEGORY_ID_WITH_DESCENDANTS field.

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 ratings now factor in trust signals, with reviews from lower-trust shops carrying less weight.

Inventory Transfers developer preview is now available, allowing you to test enhanced multi-location inventory management features and build integrations for complex inventory movements.

The GraphQL Storefront API now supports setting cart attributes with blank keys or values, aligning with the AJAX API's behavior.

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

Stable API versions now retroactively add GraphQL Enum values. Refresh introspection caches and implement catch-alls to avoid toolchain disruptions.

We've added new FulfillmentOrderRejectionReason enum values for more detailed error messages.

As of API version 2025-04 of the GraphQL Admin API, the productSet and customerSet mutations can upsert by identifier, simplifying record management.

Shopify-approved finance apps can access shop finance details and subscribe to related webhooks

Added rfmGroup field to customer statistics in the Admin GraphQL Admin API to expose customer segmentation data based on purchasing patterns.

The draftOrderCount query is now available in the 2025-07 stable version of the GraphQL Admin API. Previously, it was...

@inContext directive added to the 2025-04 version of the Customer Account API to help integrate with international markets

Added new enum values to CustomerPaymentMethodRevocationReason: CUSTOMER_REDACTED, TOO_MANY_CONSECUTIVE_FAILURES, CVV_ATTEMPTS_LIMIT_EXCEEDED

The themeFilesUpsert mutation now returns theme file metadata directly, eliminating the need for extra fetch requests to verify updates.

You can now remove cart and checkout attributes by passing the attribute key you wish to remove with the AttributeRemoveChange property.

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

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

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

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

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

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

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.

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.

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.

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

Renamed NewTextFieldProps to TextFieldProps. Added support for transaction complete, cash tracking, and receipt footer targets. Introduced POSReceiptBlock component for receipt footer.

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.