Key details

  1. Preact 11 released September 29, 2026.
  2. Hydration 2.0 supports zero or multiple DOM nodes across async boundaries.
  3. Core and add-ons ship as ESM .mjs; old CommonJS/UMD bundles are removed.
  4. Automatic ref forwarding and Object.is hook equality are added.
  5. The official upgrade guide documents affected import paths and wrappers.
  6. Preact first-party packages were prepared for v11 during prereleases.

What builders should take away

  1. Audit CommonJS-only consumers, UMD globals and direct preact/dist imports.
  2. Test SSR hydration and async boundaries after upgrading.
  3. Run TypeScript builds to catch stricter type checks.
  4. Use the official upgrade guide and first-party package compatibility list.

What changed

The Preact team released Preact 11 on September 29, 2026. It adds Hydration 2.0 that supports async boundaries with zero or multiple DOM nodes, automatic ref forwarding, Object.is equality in hook arguments and stricter types. Preact core and add-ons are now distributed as .mjs ES modules; CommonJS and UMD bundles from Preact 10 have been removed except for a few compatibility wrappers. First-party packages including Signals, render-to-string, preact-iso and preset-vite already support v11.

Why it matters

Preact is used as a small React-compatible UI runtime, and the major changes both server-rendered hydration flexibility and package consumption. ESM-only distribution aligns with modern bundlers but can break legacy script tags, direct dist imports and CommonJS-only build chains. The upgrade is a compatibility decision, not just a dependency bump.

Hydration 2.0 relaxes async boundary constraints

Preact 10 required exactly one DOM node in some async boundary cases. Preact 11 supports zero or multiple nodes, allowing more flexible component composition and hydration.

ESM-only packages are a real breaking change

Core and add-ons now ship .mjs modules, dropping old CommonJS and UMD bundles. Modern require(esm) environments can work, but direct legacy paths and older loaders need migration.

Ref and hook behaviour changes

Automatic ref forwarding and Object.is-based hook equality align behaviour with modern component expectations; stricter types can expose previously accepted patterns.

The official ecosystem is already prepared

Preact's first-party packages were updated during prereleases, reducing migration friction for supported modern tooling.

What to watch next

  • Compatibility reports from older bundlers and SSR integrations.
  • Migration regressions around hydration and refs.
  • Broader ecosystem adoption of the ESM-only package.

Still unclear

  • Compatibility with legacy toolchains varies by Node/runtime and bundler version.
  • The team characterises most upgrades as straightforward, but application-specific behaviour still needs testing.

Sources

Direct reading behind this dossier.

2 sources
Preact 11
Preact Team primary

Official release rationale and new features.

Discussion

Discussion is reader-contributed. Comments are not part of the BTN dossier or its editorial evidence.

0 visible comments

Join the discussion

Keep comments useful and relevant. Reader contributions may be moderated and are not BTN editorial evidence.

Sign in to comment