The Hydrogen October 2025 release (v2025.10.0) is out. This release updates the Storefront API and Customer Account API to 2025-10 and adds new cart mutations that simplify multi-gift-card and multi-address checkout flows.
We’re discouraging use of OrderTransaction.receiptJson . You should stop relying on receiptJson in production apps. receiptJson is gateway-defined , inconsistently shaped , and may change without notice . Because its structure isn’t stable or typed, changes can lead to unexpected app failures.
Admin UI extensions for Discount Functions can now interact with the selected discount method and manage discount classes, letting you customize the discount configuration experience directly within the Shopify admin. This is a non-breaking change that adds new functionality to existing discount UI extensions.
Starting with POS 10.19.0 , unhandled errors in extension callbacks trigger an error page instead of failing silently. This change ensures a more stable and predictable experience for merchants and helps developers identify issues proactively.
As of January 26, 2026, Checkout UI extensions that support blocking now default to non-blocking behavior. To enable blocking, merchants must explicitly activate the Allow app to block checkout setting in the checkout and accounts editor.
Starting in POS 10.19, you can now localize your POS UI extensions for international merchants, staff, and customers. You can Translate extension text : Define locale files with translation strings that automatically resolve based on customer and shop locales.
shopify app import-custom-data-definitions is now available in Shopify CLI version 3.89. This command helps you migrate existing metafield and metaobject definitions for your app to declarative TOML management . All app-owned definitions configured on your dev store are automatically converted to their TOML equivalent.
As of API version 2026-04, the Storefront API will return a MERCHANDISE_LINE_TRANSFORMERS_RUN_ERROR cart error code when a Cart Transform Function encounters a runtime error during cart operations such as cartCreate or cartLinesAdd .
Shopify will stop setting the shopify_y and shopify_s cookies in 2026. If you use these cookies, your storefront will continue to work normally. However, if you don’t upgrade, visitor and session attribution won't be reliable in in Shopify Analytics. For Hydrogen storefronts, upgrade by April 30, 2026.
Starting January 13, 2026, Shopify is enforcing stricter Liquid parsing for all themes. This improves code quality, prevents syntax errors, and enables future Liquid enhancements. If your theme contains Liquid code that doesn't meet the stricter parsing requirements, we'll automatically rewrite those files to be compatible.
We're updating the format of versioning query parameters appended to store assets such as CSS and JS. Previously, some assets used a bare numeric query parameter, (for example, ?108 ), while others used a key-value format with the v query parameter. Moving forward, all asset URLs will consistently use the ?v=VERSION_STRING format for versioning.
Support for legacy mode profiles in shipping has been discontinued, as this feature has been inactive for some time. Consequently, the GraphQL Admin API is being updated to align with this change.
Beginning in API version 2026-01, billing attempts will be throttled based on internal trust metrics to prevent abuse. If an attempt is throttled, it will be visible in the new throttled error code on the BillingAttemptUserErrorCode enum.
Releasesby Glyph