Skip to content

@shopify/hydrogen-react@2026.4.0

Choose a tag to compare

@shopify-github-actions-access shopify-github-actions-access released this 09 Apr 18:32
· 23 commits to main since this release
7e1f486

Major Changes

  • Update Storefront API and Customer Account API from 2026-01 to 2026-04. (#3651) by @itsjustriley

    Breaking changes

    JSON metafield values limited to 128KB: When using API version 2026-04 or later, the Storefront API limits JSON type metafield writes to 128KB. This limit applies at the API level - Hydrogen passes through to the Storefront API without additional restriction. Apps that used JSON metafields before April 1, 2026 are grandfathered at the existing 2MB limit. Large metafield values continue to be readable by all API versions.

    New features

    New MERCHANDISE_LINE_TRANSFORMERS_RUN_ERROR cart error code: Cart operations (cartCreate, cartLinesAdd, etc.) now return a specific MERCHANDISE_LINE_TRANSFORMERS_RUN_ERROR error code when a Cart Transform Function fails at runtime, instead of the previous generic INVALID error code. If you handle cart errors in your storefront code, you may want to add handling for this new code.

    Changelog links