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.

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.

As of version 2025-07 of the GraphQL Storefront API, Cart now provides warnings for non-applicable discount codes.

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.

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

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

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

GraphQL count APIs now return uncapped results with limit=null. All APIs standardized; limit defaults to 10000, introducing a breaking change.

Shopify Functions now supports 25 active functions per API, up from 5, enabling developers to better organize logic for payments, delivery, and cart and checkout validations.

Starting June 1st, 2025, apps must meet the simplified BFS design requirements when submitting for review/renewal to be eligible for the BFS program.

The Order Edit API allows you to edit line items containing selling plans before an order ships.

Starting May 20, 2025, apps can refund to store credit regardless of original payment. Store credit is visible in customer profiles and accessible via GraphQL Admin API.

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

New API endpoint retrieves delivery options for draft orders, including shipping rates and local pickup, with pagination. Requires read_draft_orders access scope. Replaces legacy field.

Hydrogen v2025.4.0 updates SFAPI, fixes internationalization and cart issues, improves logout handling, deprecates <VariantSelector />, and refactors ProductItem component.

Metafields access is changing: PUBLIC access is removed, now set to MERCHANT_READ_WRITE. Migrate to a custom namespace if other apps need read access.

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.

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.

API version 2025-07 deprecates the draftOrderCreateMerchantCheckout mutation.

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

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.

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.

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

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

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

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

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

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

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

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.