Developer changelog

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

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

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

Added FREE_GIFT_CARD_NOT_ALLOWED to SubscriptionBillingAttemptErrorCode enum, preventing subscriptions from including gift cards sold at a zero price.

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

You can now pass arbitrary parameters to static blocks.

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.

Group similar section and block presets using the new category property.

Cart AJAX API now supports adding/removing discounts via the discount parameter in /cart/update.js.

{% stylesheet %} and {% javascript %} tags now work in snippets

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.

You can now allocate refunds as new store credit alongside original payment methods. Requires new customer accounts and customer-associated orders.

Shopify themes must meet new requirements for submitting and updating theme listings, starting May 15, 2025.

To increase the trustworthiness of the Shopify App Store, we’re archiving a significant number of outdated, unhelpful, and untrusted reviews.

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

Adds BUYER_CANNOT_PURCHASE_FOR_COMPANY_LOCATION error code to CartErrorCode.

Display customer store credit on storefront using the new store_credit_account object via customer.store_credit_account.balance.

Shopify is retiring gates types and fields in favour of metafields and metaobjects for better custom data management across Admin, Storefront, and Functions APIs.

New query parameters name and confirmation_number added to the orders connection in the GraphQL Customer Account API, enabling more precise order filtering.

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.

Shopify's GraphQL now supports retrieving Shop Pay payment details using source_identifier or receipt token, streamlining workflows for merchants using Shop Component.

API version 2025-07 deprecates the draftOrderCreateMerchantCheckout mutation.

event.data.checkout.subtotalPrice.amount on the new /thank-you page now sums line item prices after product and order discounts, aligning with the old /thank_you page.

We’ve added new automated checks to the Shopify App Store review process to help you prepare your app for submission, provide faster feedback, and prevent common errors.

Display a modal after purchase with the new paymentSessionModal mutation.

Developers will continue to enjoy a revshare exemption on the first $1 million USD of lifetime revenue, and a 15% share on amounts above that.

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

The publicDisplayName field is added to ShopPlan. The Shopify plan is now Grow. Update to publicDisplayName as displayName will be deprecated.

Starting April 29, 2025, payment apps can no longer be embedded in the Shopify admin.

Automatically create smart collections with the new PRODUCT_CATEGORY_ID_WITH_DESCENDANTS field.

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.

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.

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.

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