@shopify/hydrogen-react@2026.4.0
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_ERRORcart error code: Cart operations (cartCreate,cartLinesAdd, etc.) now return a specificMERCHANDISE_LINE_TRANSFORMERS_RUN_ERRORerror code when a Cart Transform Function fails at runtime, instead of the previous genericINVALIDerror code. If you handle cart errors in your storefront code, you may want to add handling for this new code.Changelog links