How often does Hydrogen ship releases and breaking changes, and how long do older versions stay supported?

Hydrogen published 9 stable releases in 2025 and 34 in 2024, then 14 in the first quarter of 2026, according to npm publish dates read November 18, 2026. Of 12 majors with a stated API version, 3 still targeted a supported Storefront API version on that date. Updated November 18, 2026.

By Martin DejnickiUpdated Data through November 18, 2026

Short answer

Hydrogen published 9 stable releases in 2025, against 34 in 2024, and 14 in the first quarter of 2026 alone, according to npm publish dates for @shopify/hydrogen read November 18, 2026. On that date, only 3 of 12 majors with a stated Storefront API version still targeted a version inside Shopify's support window, as computed by Deploi from Shopify's versioning policy.

Hydrogen shipped no stable release in Q4 2025, then 14 in Q1 2026, when two majors landed

Stable @shopify/hydrogen versions published on npm per calendar quarter, Q1 2024 to Q4 2026 (Q4 2026 to November 18)

2024-Q1 142024-Q2 92024-Q3 82024-Q4 32025-Q1 42025-Q2 42025-Q3 12025-Q4 02026-Q1 142026-Q2 62026-Q3 22026-Q4 62024-Q12024-Q22024-Q32024-Q42025-Q12025-Q22025-Q32025-Q42026-Q22026-Q32026-Q42026-Q114983441062614two majorsto Nov 18

  • Counts every version without a prerelease tag published to npm in the quarter (UTC), patches included; computed by Deploi.
  • Q4 2026 counts releases to November 18, 2026, the day the registry was read.
  • The 2025.10.0 major shipped on January 30, 2026 and 2026.1.0 on February 9, 2026, so a version's name does not give its release quarter.
  • The data table lists every quarter from Q3 2021; the chart draws the 12 most recent.

Source: npm registry document for @shopify/hydrogen (publish dates), read November 18, 2026. Counts computed by Deploi. Read on .

What this means for your decision

  • Budgeting upgrades for a Hydrogen storefront? Hydrogen shipped three or four calendar majors a year from 2023 to 2026, and 11 of the 14 majors assessed list breaking changes, according to npm publish dates and the Shopify/hydrogen changelog read November 18, 2026. Plan a recurring upgrade window every year. The counts do not measure upgrade hours, which depend on the store.
  • Timing the next upgrade? Support follows the Storefront API version a major targets, which Shopify supports for a minimum of 12 months from that version's release, not from the day the major ships. 2025.10.0 shipped January 30, 2026, and the 12-month minimum for its API version ran only to October 1, 2026. Plan from the support end in the table, computed by Deploi as that minimum, not from the version name.
  • Reading the release counts? The fall from 34 stable releases in 2024 to 9 in 2025 counts patches as well as majors, so it is not a fall in breaking work; 2026 had 14 releases in the first quarter alone.
  • Checking whether your storefront is on a supported version? At November 18, 2026, three majors target a supported API version: 2026.1.0 until January 1, 2027, 2026.4.0 until April 1, 2027 and 2026.10.0 until October 1, 2027, computed by Deploi. Each date is the 12-month minimum for that API version, not the day a storefront stops working, and Shopify's table prints a slightly later access date for each version, such as October 16, 2026 for 2025-10.
  • Short on time for the next upgrade? Contact Deploi to plan it against your API version's support end.

How often does Hydrogen ship a stable release?

Hydrogen published 9 stable releases in 2025, down from 34 in 2024 and 40 in 2023, according to npm publish dates for @shopify/hydrogen read November 18, 2026. It then published 14 in the first quarter of 2026. Quarterly counts range from none in Q4 2025 to 26 in Q2 2022.

Annual totals are sums of the quarterly counts, computed by Deploi. Each count includes every version without a prerelease tag, patches included, by UTC publish date. Prereleases such as next, snapshot and experimental are excluded.

The quarter table starts in Q3 2021 with 3 releases. Q4 2026 had 6 releases through November 18, 2026, so it is not a full quarter.

How many calendar majors does Hydrogen ship a year, and do they break things?

Hydrogen shipped 4 calendar majors in 2023, 3 in 2024, 4 in 2025 and 4 so far in 2026, counted by npm release date as of November 18, 2026. Of the 14 majors whose release notes were assessed, 11 list breaking changes, according to the Shopify/hydrogen changelog captured the same day.

The three majors without breaking changes are 2025.1.0, 2025.4.0 and 2025.5.0. The release notes for 2023.1.0 were not assessed for the flag.

Breaking means the release notes list breaking changes. It does not say how many, or how long a migration takes.

How long does a Hydrogen major stay supported?

Deploi dates a Hydrogen major's support by the Storefront API version it targets, which Shopify supports for a minimum of 12 months from that version's release. Deploi computes each support end as the API version's release date plus 12 months. The 2025.10.0 major shipped January 30, 2026, and the 12-month minimum for its API version ran to October 1, 2026; Shopify lists that version as accessible until October 16, 2026.

Support is a property of the Storefront API version a release targets, not of the Hydrogen package. Shopify's versioning table prints a slightly later access date for recent versions, so the computed dates are the conservative end.

The support timeline covers 12 majors. Three are not drawn because their captured release notes name no Storefront API version: 2023.1.0, 2024.4.0 and 2025.5.0.

Of 12 Hydrogen majors with a stated API version, only 2026.1.0, 2026.4.0 and 2026.10.0 were still supported on November 18, 2026

Each Hydrogen calendar major from its npm release to the end of support of the Storefront API version it targets, 2023 to 2027

2023.4.0 Released: Apr 20, 2023 API version supported until: Apr 1, 2024 Status: Support ended 2023-042023.7.0 Released: Jul 25, 2023 API version supported until: Jul 1, 2024 Status: Support ended 2023-072023.10.0 Released: Oct 31, 2023 API version supported until: Oct 1, 2024 Status: Support ended 2023-102024.1.0 Released: Jan 25, 2024 API version supported until: Jan 1, 2025 Status: Support ended 2024-012024.10.0 Released: Oct 29, 2024 API version supported until: Oct 1, 2025 Status: Support ended 2024-102025.1.0 Released: Jan 30, 2025 API version supported until: Jan 1, 2026 Status: Support ended 2025-012025.4.0 Released: May 19, 2025 API version supported until: Apr 1, 2026 Status: Support ended 2025.042025.7.0 Released: Sep 30, 2025 API version supported until: Jul 1, 2026 Status: Support ended 2025-072025.10.0 Released: Jan 30, 2026 API version supported until: Oct 1, 2026 Status: Support ended 2025-102026.1.0 Released: Feb 9, 2026 API version supported until: Jan 1, 2027 Status: Supported 2026-012026.4.0 Released: Apr 9, 2026 API version supported until: Apr 1, 2027 Status: Supported 2026-042026.10.0 Released: Oct 9, 2026 API version supported until: Oct 1, 2027 Status: Supported 2026-10

  • Support ends are the API version's release date plus Shopify's minimum 12-month support window, computed by Deploi; Shopify's versioning table prints a slightly later access date for recent versions.
  • Status is the support of the API version a release targets, not of the Hydrogen package itself.
  • Three majors are not drawn because their captured release notes name no Storefront API version: 2023.1.0, 2024.4.0 and 2025.5.0.
  • 2025.10.0 shipped on January 30, 2026, and support for its API version, 2025-10, ended on October 1, 2026.

Source: npm registry and Shopify/hydrogen CHANGELOG, read November 18, 2026; Shopify, About Shopify API versioning, retrieved October 18, 2026. Support ends computed by Deploi. Read on .

Which Hydrogen versions are still supported?

On November 18, 2026, three Hydrogen majors targeted a Storefront API version still inside Shopify's 12-month minimum support window: 2026.1.0 until January 1, 2027, 2026.4.0 until April 1, 2027 and 2026.10.0 until October 1, 2027. That minimum had passed for the other 9 of 12 majors with a stated API version, including 2025.10.0 on October 1, 2026, computed by Deploi from Shopify's API versioning page.

Status is computed against November 18, 2026, the day Deploi read the npm registry and the changelog, and changes as dates pass.

The table lists each major with its API version and support end.

Does a version's name tell you when it shipped?

No. A Hydrogen calendar major's name does not give its release quarter: 2025.10.0 shipped on January 30, 2026, and 2026.1.0 followed on February 9, 2026, according to npm publish dates. Two majors landed in the first quarter of 2026, and none had shipped in the fourth quarter of 2025.

The 2025.4.0 major shipped on May 19, 2025 and 2025.5.0 two days later, on May 21, so 2025.4.0 did not ship in April either.

Plan upgrades from the publish date and the API version's support end, not from the version label.

What does this say about the maintenance burden of a headless build?

Hydrogen's published record shows frequent releases and frequent breaking majors: 34 stable releases in 2024, 11 of 14 assessed majors listing breaking changes, and Shopify supporting each major's API version for a minimum of 12 months from that version's release. It does not show how many hours an upgrade takes, which depends on the store.

Use the cadence to plan a recurring upgrade window. Three or four majors have shipped each year since 2023, most listing breaking changes. Shopify's minimum support for the API version a major targets runs 12 months from that version's release, not from the day the major ships.

The data does not measure upgrade effort, and release counts say nothing about how many stores are affected. For the notice period before enforcement, see Deploi's page on how much notice Shopify gives between announcing a deprecation and enforcing it.

The data

Each chart on this page is drawn from the numbers below. Units are in the column headers.

Hydrogen shipped no stable release in Q4 2025, then 14 in Q1 2026, when two majors landed

Hydrogen shipped no stable release in Q4 2025, then 14 in Q1 2026, when two majors landed
QuarterStable releases in quarter
2021-Q33
2021-Q417
2022-Q113
2022-Q226
2022-Q39
2022-Q48
2023-Q19
2023-Q29
2023-Q314
2023-Q48
2024-Q114
2024-Q29
2024-Q38
2024-Q43
2025-Q14
2025-Q24
2025-Q31
2025-Q40
2026-Q114
2026-Q26
2026-Q32
2026-Q46

Download Hydrogen stable releases per quarter and support windows of its calendar majors, 2021 to November 18, 2026 as CSV · All 11 columns on the dataset page

Of 12 Hydrogen majors with a stated API version, only 2026.1.0, 2026.4.0 and 2026.10.0 were still supported on November 18, 2026

Of 12 Hydrogen majors with a stated API version, only 2026.1.0, 2026.4.0 and 2026.10.0 were still supported on November 18, 2026
Hydrogen versionReleasedAPI version supported untilStatus on November 18, 2026Storefront API versionBreaking changes listed (yes or no)
2023.4.0Apr 20, 2023Apr 1, 2024Support ended2023-04yes
2023.7.0Jul 25, 2023Jul 1, 2024Support ended2023-07yes
2023.10.0Oct 31, 2023Oct 1, 2024Support ended2023-10yes
2024.1.0Jan 25, 2024Jan 1, 2025Support ended2024-01yes
2024.10.0Oct 29, 2024Oct 1, 2025Support ended2024-10yes
2025.1.0Jan 30, 2025Jan 1, 2026Support ended2025-01no
2025.4.0May 19, 2025Apr 1, 2026Support ended2025.04no
2025.7.0Sep 30, 2025Jul 1, 2026Support ended2025-07yes
2025.10.0Jan 30, 2026Oct 1, 2026Support ended2025-10yes
2026.1.0Feb 9, 2026Jan 1, 2027Supported2026-01yes
2026.4.0Apr 9, 2026Apr 1, 2027Supported2026-04yes
2026.10.0Oct 9, 2026Oct 1, 2027Supported2026-10yes

Download Hydrogen stable releases per quarter and support windows of its calendar majors, 2021 to November 18, 2026 as CSV · All 11 columns on the dataset page

Methodology

Reading the chart: Hydrogen shipped no stable release in Q4 2025, then 14 in Q1 2026, when two majors landed

  • Counts every version without a prerelease tag published to npm in the quarter (UTC), patches included; computed by Deploi.
  • Q4 2026 counts releases to November 18, 2026, the day the registry was read.
  • The 2025.10.0 major shipped on January 30, 2026 and 2026.1.0 on February 9, 2026, so a version's name does not give its release quarter.
  • The data table lists every quarter from Q3 2021; the chart draws the 12 most recent.

Reading the chart: Of 12 Hydrogen majors with a stated API version, only 2026.1.0, 2026.4.0 and 2026.10.0 were still supported on November 18, 2026

  • Support ends are the API version's release date plus Shopify's minimum 12-month support window, computed by Deploi; Shopify's versioning table prints a slightly later access date for recent versions.
  • Status is the support of the API version a release targets, not of the Hydrogen package itself.
  • Three majors are not drawn because their captured release notes name no Storefront API version: 2023.1.0, 2024.4.0 and 2025.5.0.
  • 2025.10.0 shipped on January 30, 2026, and support for its API version, 2025-10, ended on October 1, 2026.

Caveats: Hydrogen stable releases per quarter and support windows of its calendar majors, 2021 to November 18, 2026

  • A release count includes every version without a prerelease tag (x.y.z only), patches included, by UTC publish date. Prereleases such as next, snapshot and experimental are excluded. Q4 2026 counts releases to November 18, 2026 and is not a full quarter.
  • Support ends are computed by Deploi as the Storefront API version's release date plus 12 months, the minimum support window on Shopify's API versioning page: supportedUntil is that 12-month minimum, not the access date Shopify prints. Shopify's versioning table lists 2025-10 as accessible until October 16, 2026 15:00 UTC, later than the minimum. Status is the support of the API version a release targets, not of the Hydrogen package itself. storefrontApiVersion is printed as in the changelog (2025.04 for 2025.4.0).
  • Status is read at November 18, 2026 and changes as dates pass.
  • Three majors name no Storefront API version in the release notes Deploi captured: 2023.1.0, 2024.4.0 and 2025.5.0. They have no support window and are not drawn on the timeline.
  • Breaking is yes when the release notes in the Shopify/hydrogen changelog list breaking changes. It does not say how many changes there are or how long a migration takes. It is empty for 2023.1.0, which was not assessed.
  • A version's name does not give its release quarter. The 2025.10.0 major shipped on January 30, 2026, and 2025.4.0 shipped on May 19, 2025.
  • The data covers Hydrogen's published releases. It does not measure upgrade effort or how many stores run each version.

Deploi's charts and compilation are licensed CC BY 4.0. The underlying facts belong to their sources, which are named on every page. How Deploi Shopify Data works.

Sources

Tier A sources are primary documents: filings, official releases and official price pages. How sources are ranked.

Cite and reuse

Deploi's charts and compilation are licensed CC BY 4.0. The underlying facts belong to their sources, which are named on every page.

APA

Deploi. (2026). How often does Hydrogen ship releases and breaking changes, and how long do older versions stay supported? [Web page]. https://deploi.ca/shopify/data/hydrogen-release-cadence Retrieved November 18, 2026.

BibTeX

@misc{deploi_hydrogen_release_cadence_2026,
  author = {{Deploi}},
  title = {How often does Hydrogen ship releases and breaking changes, and how long do older versions stay supported?},
  year = {2026},
  url = {https://deploi.ca/shopify/data/hydrogen-release-cadence},
  note = {Accessed 2026-11-18}
}

Embed a chart

Embed: Hydrogen shipped no stable release in Q4 2025, then 14 in Q1 2026, when two majors landed

Embed code

<iframe src="https://deploi.ca/embed/shopify/data/hydrogen-releases-per-quarter" title="Hydrogen shipped no stable release in Q4 2025, then 14 in Q1 2026, when two majors landed" loading="lazy" style="width:100%;height:630px;border:0"></iframe>
<p style="font:12px/1.4 Arial,sans-serif;margin:4px 0 0">Source: <a href="https://deploi.ca/shopify/data/hydrogen-release-cadence#chart-hydrogen-releases-per-quarter">Deploi, Hydrogen shipped no stable release in Q4 2025, then 14 in Q1 2026, when two majors landed</a></p>
Embed: Of 12 Hydrogen majors with a stated API version, only 2026.1.0, 2026.4.0 and 2026.10.0 were still supported on November 18, 2026

Embed code

<iframe src="https://deploi.ca/embed/shopify/data/hydrogen-version-support-timeline" title="Of 12 Hydrogen majors with a stated API version, only 2026.1.0, 2026.4.0 and 2026.10.0 were still supported on November 18, 2026" loading="lazy" style="width:100%;height:800px;border:0"></iframe>
<p style="font:12px/1.4 Arial,sans-serif;margin:4px 0 0">Source: <a href="https://deploi.ca/shopify/data/hydrogen-release-cadence#chart-hydrogen-version-support-timeline">Deploi, Of 12 Hydrogen majors with a stated API version, only 2026.1.0, 2026.4.0 and 2026.10.0 were still supported on November 18, 2026</a></p>

Keep the credit line under the embed. It is the license condition.

Downloads

  • Chart: Hydrogen shipped no stable release in Q4 2025, then 14 in Q1 2026, when two majors landed PNG
  • Chart: Of 12 Hydrogen majors with a stated API version, only 2026.1.0, 2026.4.0 and 2026.10.0 were still supported on November 18, 2026 PNG
  • Data: Hydrogen stable releases per quarter and support windows of its calendar majors, 2021 to November 18, 2026 CSV

Questions

How often does Hydrogen release a new version?

Hydrogen published 34 stable releases in 2024 and 9 in 2025, according to npm publish dates for @shopify/hydrogen read November 18, 2026. Counts include patches and exclude prereleases. In 2026 it had published 14 in Q1, 6 in Q2, 2 in Q3 and 6 in Q4 through November 18.

How long is a Hydrogen version supported?

Deploi dates a Hydrogen major's support by the Storefront API version it targets, which Shopify supports for a minimum of 12 months from the version's release. Deploi computes each support end as the API release date plus 12 months, from Shopify's API versioning page retrieved October 18, 2026.

Which Hydrogen versions are supported now?

As of November 18, 2026, three majors target a Storefront API version that is still supported: 2026.1.0 until January 1, 2027, 2026.4.0 until April 1, 2027 and 2026.10.0 until October 1, 2027. The dates are Shopify's 12-month minimum, computed by Deploi as each API version's release date plus 12 months, and the list shrinks as they pass.

Does every Hydrogen major have breaking changes?

No. Of the 14 majors assessed from the Shopify/hydrogen changelog captured November 18, 2026, 11 list breaking changes. The three that do not are 2025.1.0, 2025.4.0 and 2025.5.0. A listed breaking change does not say how large the migration is.

Why did Hydrogen have no stable release in Q4 2025?

The npm registry shows no stable version published between October 1 and December 31, 2025. The 2025.10.0 major shipped on January 30, 2026, followed by 2026.1.0 on February 9, 2026. Shopify does not explain the gap in these sources.

More on Performance and technology

Changes

  1. · Hydrogen stable releases per quarter and support windows of its calendar majors, 2021 to November 18, 2026
    First published.
Deploi is not affiliated with Shopify. Questions about this data: contact@deploi.ca.