[ci] release 2026.4.0 (#3676)

shopify-github-actions-access[bot] · github-actions[bot] · itsjustriley · web-flow · commit 7e1f4861ba27 · 2026-04-09T14:29:48.000-04:00
* [ci] release 2026.4.0

* chore: trigger CI

---------

Co-authored-by: github-actions[bot] &lt;41898282+github-actions[bot]@users.noreply.github.com&gt;
Co-authored-by: Riley Nowak &lt;riley.nowak@shopify.com&gt;
diff --git a/.changeset/backend-consent-enabled.md b/.changeset/backend-consent-enabled.md
diff --git a/.changeset/permissive-rr-peerdeps.md b/.changeset/permissive-rr-peerdeps.md
diff --git a/.changeset/sfapi-caapi-2026-04-update.md b/.changeset/sfapi-caapi-2026-04-update.md
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
@@ -1,5 +1,25 @@
 # @shopify/cli-hydrogen
 
+## 11.1.14
+
+### Patch Changes
+
+- Widen React Router peer dependencies from exact versions to caret ranges (`^7.12.0`). This allows Hydrogen projects to use newer React Router minor versions without peer dependency conflicts, particularly with npm's strict resolver. Hydrogen only uses stable public APIs from React Router, so minor version updates are backwards-compatible. ([#3677](https://github.com/Shopify/hydrogen/pull/3677)) by [@fredericoo](https://github.com/fredericoo)
+
+- Update Storefront API and Customer Account API from 2026-01 to 2026-04. ([#3651](https://github.com/Shopify/hydrogen/pull/3651)) by [@itsjustriley](https://github.com/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
+  - [Storefront API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=storefront-graphql)
+  - [Customer Account API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=customer-account-graphql)
+
 ## 11.1.13
 
 ### Patch Changes
diff --git a/packages/cli/oclif.manifest.json b/packages/cli/oclif.manifest.json
@@ -1675,5 +1675,5 @@
       ]
     }
   },
-  "version": "11.1.13"
+  "version": "11.1.14"
 }
diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -4,7 +4,7 @@
     "access": "public",
     "@shopify:registry": "https://registry.npmjs.org"
   },
-  "version": "11.1.13",
+  "version": "11.1.14",
   "license": "MIT",
   "type": "module",
   "repository": {
diff --git a/packages/create-hydrogen/CHANGELOG.md b/packages/create-hydrogen/CHANGELOG.md
@@ -1,5 +1,23 @@
 # @shopify/create-hydrogen
 
+## 5.0.33
+
+### Patch Changes
+
+- Update Storefront API and Customer Account API from 2026-01 to 2026-04. ([#3651](https://github.com/Shopify/hydrogen/pull/3651)) by [@itsjustriley](https://github.com/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
+  - [Storefront API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=storefront-graphql)
+  - [Customer Account API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=customer-account-graphql)
+
 ## 5.0.32
 
 ### Patch Changes
diff --git a/packages/create-hydrogen/package.json b/packages/create-hydrogen/package.json
@@ -5,7 +5,7 @@
     "@shopify:registry": "https://registry.npmjs.org"
   },
   "license": "MIT",
-  "version": "5.0.32",
+  "version": "5.0.33",
   "type": "module",
   "repository": {
     "type": "git",
diff --git a/packages/hydrogen-react/CHANGELOG.md b/packages/hydrogen-react/CHANGELOG.md
@@ -1,5 +1,23 @@
 # @shopify/hydrogen-react
 
+## 2026.4.0
+
+### Major Changes
+
+- Update Storefront API and Customer Account API from 2026-01 to 2026-04. ([#3651](https://github.com/Shopify/hydrogen/pull/3651)) by [@itsjustriley](https://github.com/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
+  - [Storefront API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=storefront-graphql)
+  - [Customer Account API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=customer-account-graphql)
+
 ## 2026.1.2
 
 ### Patch Changes
diff --git a/packages/hydrogen-react/package.json b/packages/hydrogen-react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@shopify/hydrogen-react",
-  "version": "2026.1.2",
+  "version": "2026.4.0",
   "description": "React components, hooks, and utilities for creating custom Shopify storefronts",
   "homepage": "https://github.com/Shopify/hydrogen/tree/main/packages/hydrogen-react",
   "license": "MIT",
diff --git a/packages/hydrogen/CHANGELOG.md b/packages/hydrogen/CHANGELOG.md
@@ -1,5 +1,34 @@
 # @shopify/hydrogen
 
+## 2026.4.0
+
+### Major Changes
+
+- Make Storefront API proxy mandatory and enable backend consent mode, supporting the deprecation of the `_tracking_consent` cookie in favor of server-set cookies via the SF API proxy. ([#3649](https://github.com/Shopify/hydrogen/pull/3649)) by [@itsjustriley](https://github.com/itsjustriley)
+  - **Breaking**: `proxyStandardRoutes` option has been removed from `createRequestHandler`. The Storefront API proxy is now always enabled. If your load context does not include a `storefront` instance, the request handler will now throw an error instead of logging a warning.
+  - **New**: `window.Shopify.customerPrivacy.backendConsentEnabled` is now set to `true` before the Customer Privacy API script loads. This tells the consent library to use the new server-set cookie mode instead of the legacy `_tracking_consent` JS cookie. The flag is installed via a `window.Shopify` property interceptor so it survives the CDN's `window.Shopify = {}` reset cycle and is readable before the full API is assigned.
+
+- Update Storefront API and Customer Account API from 2026-01 to 2026-04. ([#3651](https://github.com/Shopify/hydrogen/pull/3651)) by [@itsjustriley](https://github.com/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
+  - [Storefront API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=storefront-graphql)
+  - [Customer Account API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=customer-account-graphql)
+
+### Patch Changes
+
+- Widen React Router peer dependencies from exact versions to caret ranges (`^7.12.0`). This allows Hydrogen projects to use newer React Router minor versions without peer dependency conflicts, particularly with npm's strict resolver. Hydrogen only uses stable public APIs from React Router, so minor version updates are backwards-compatible. ([#3677](https://github.com/Shopify/hydrogen/pull/3677)) by [@fredericoo](https://github.com/fredericoo)
+
+- Updated dependencies [[`b0caa5c013380c7837f049f48da089a1671e2c6d`](https://github.com/Shopify/hydrogen/commit/b0caa5c013380c7837f049f48da089a1671e2c6d)]:
+  - @shopify/hydrogen-react@2026.4.0
+
 ## 2026.1.4
 
 ### Minor Changes
diff --git a/packages/hydrogen/package.json b/packages/hydrogen/package.json
@@ -5,7 +5,7 @@
     "@shopify:registry": "https://registry.npmjs.org"
   },
   "type": "module",
-  "version": "2026.1.4",
+  "version": "2026.4.0",
   "license": "MIT",
   "main": "dist/index.cjs",
   "module": "dist/production/index.js",
diff --git a/packages/hydrogen/src/version.ts b/packages/hydrogen/src/version.ts
@@ -1 +1 @@
-export const LIB_VERSION = '2026.1.4';
+export const LIB_VERSION = '2026.4.0';
diff --git a/templates/skeleton/CHANGELOG.md b/templates/skeleton/CHANGELOG.md
@@ -1,5 +1,28 @@
 # skeleton
 
+## 2026.4.0
+
+### Major Changes
+
+- Update Storefront API and Customer Account API from 2026-01 to 2026-04. ([#3651](https://github.com/Shopify/hydrogen/pull/3651)) by [@itsjustriley](https://github.com/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
+  - [Storefront API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=storefront-graphql)
+  - [Customer Account API 2026-04 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-04&api_type=customer-account-graphql)
+
+### Patch Changes
+
+- Updated dependencies [[`e7215ed0d7a74cacfa8c935f414c1cf32fc2ccd0`](https://github.com/Shopify/hydrogen/commit/e7215ed0d7a74cacfa8c935f414c1cf32fc2ccd0), [`92ab8e8b59807bbdb5dbecaa18629292d5566135`](https://github.com/Shopify/hydrogen/commit/92ab8e8b59807bbdb5dbecaa18629292d5566135), [`b0caa5c013380c7837f049f48da089a1671e2c6d`](https://github.com/Shopify/hydrogen/commit/b0caa5c013380c7837f049f48da089a1671e2c6d)]:
+  - @shopify/hydrogen@2026.4.0
+
 ## 2026.1.4
 
 ### Patch Changes
diff --git a/templates/skeleton/package.json b/templates/skeleton/package.json
@@ -2,7 +2,7 @@
   "name": "skeleton",
   "private": true,
   "sideEffects": false,
-  "version": "2026.1.4",
+  "version": "2026.4.0",
   "type": "module",
   "scripts": {
     "build": "shopify hydrogen build --codegen",

Original file line number	Diff line number	Diff line change
`@@ -1675,5 +1675,5 @@`
`1675`	`1675`	`]`
`1676`	`1676`	`}`
`1677`	`1677`	`},`
`1678`		`- "version": "11.1.13"`
	`1678`	`+ "version": "11.1.14"`
`1679`	`1679`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@shopify/hydrogen-react",`
`3`		`- "version": "2026.1.2",`
	`3`	`+ "version": "2026.4.0",`
`4`	`4`	`"description": "React components, hooks, and utilities for creating custom Shopify storefronts",`
`5`	`5`	`"homepage": "https://github.com/Shopify/hydrogen/tree/main/packages/hydrogen-react",`
`6`	`6`	`"license": "MIT",`