# To install, choose one of these:
npm install @11ty/eleventy@canary --save-exact
npm install @awesome.me/buildawesome@alpha --save-exact

Full v4 Milestone: https://github.com/11ty/buildawesome/milestone/46?closed=1
Full Changelog: v4.0.0-alpha.7...v4.0.0-alpha.8

• Breaking (canary): bump Node minimum to 22.15+ (previously #3886 20.19+ in v4.0.0-alpha.1) #4271
• Breaking (canary): removes page.inputPathDir and page.dir (introduced in v4.0.0-alpha.5) follow along at #3794
• Feature: Batched Incremental: Fixes #4274 Adds support for multiple eligible incremental files in a single build #4275
• Adds @awesome.me/buildawesome publish and the Build Awesome rename stuff (no breaking changes), more at #4294
  • The biggest risk point here is the addition of generic file name suffixes for Directory/Template Data (e.g. .data.js paired with .11tydata.js) and JavaScript Templates (e.g. .server.js paired with .11ty.js). You may need to review your project to see if you are using these suffixes in pre-existing files.
• Using npm stage publish for extra release security hardening.
• Removes Promise.withResolvers polyfill (no longer necessary) #4289
• Fix preprocessor callbacks run twice when using --incremental #4292
• Upstream repo moved from https://github.com/11ty/eleventy to https://github.com/11ty/buildawesome
• Fix TypeScript data files not being processed by @cypressSap #4247
• Adds TypeScript types d.ts file for Configuration API (documentation pending, see @11ty/eleventy/UserConfig or @awesome.me/buildawesome/UserConfig export)
• Adds Node 26 to CI
• Fix module.register() deprecation message #4283

Thank you for PR review help from @Ryuno-Ki!
Thank you for @cristovaov for joining the Eleventy Discord moderator team!

Dependencies

• Internals: moves from debug to obug (~26KB savings, no external changes) #4291
• Bump @11ty/eleventy-dev-server from 3.0.0-alpha.6 to 3.0.0-alpha.10 #4260
  • https://github.com/11ty/dev-server/releases/tag/v3.0.0-alpha.10
  • https://github.com/11ty/dev-server/releases/tag/v3.0.0-alpha.8
• Bump @11ty/posthtml-urls from 1.0.2 to 1.0.3 #4254
• Bump liquidjs from 10.25.0 to 10.25.5 #4261
• Bump @11ty/gray-matter from 2.0.1 to 2.1.0 (dependency upgrades)
• Upgrades ava test runner (devDep) from v6 to v8

(Optional) Build Awesome Migration Guide

Add the Build Awesome dependency.

npm install @awesome.me/buildawesome@alpha --save-exact

Now change any npx @11ty/eleventy commands to use npx @awesome.me/buildawesome instead. You can optionally uninstall @11ty/eleventy (recommended for dependency simplification) but it won’t cause issues to have them both installed.

Contributors

• @Ryuno-Ki
• @cristovaov
• @cypressSap

• Fixes Node 26 module.register deprecation warning shown in console #4283 (fixed in v4 alphas in #4271)
• Minor dependency upgrades for npm audit fixes
  • liquidjs upgrade from 1.25.0 to 1.27.0
  • markdown-it upgrade from 14.1.1 to 14.2.0
• Adds Node 26 to CI for v3 branch
• Opt out of package manager cache for GitHub Actions CI release workflow (hardening security)

Milestone: https://github.com/11ty/eleventy/milestone/52?closed=1
Full Changelog: v3.1.5...v3.1.6

Installation: npm install @11ty/eleventy@canary --save-exact
v4.0 Milestone: https://github.com/11ty/eleventy/milestone/46?closed=1
Commit log (from last canary): v4.0.0-alpha.6...v4.0.0-alpha.7

Fairi warning: this may be one of the last canary releases before you see some names start to change to Build Awesome.

What’s New?

• Enables Node’s compile cache by default (opt-out available) #3499
• Update error messaging around require(esm) Node versions 2018d43
• <meta> elements need closing slash when using HTML Transformer plugins (workaround for garbage parsers) #4200
• Very experimental support for zero-config TypeScript (type stripping) support for Configuration Files, Data Files, Template files, Dependency mapping (when using --watch or --serve) on Node 22.6+ and newer #4194 #4195
• Show configuration file in use on console output #3654
• Freeze moo dependency #4240, unfreeze at #4241
• Major dependency upgrade (not breaking): entities from v7 to v8 (ESM, Node 20.19+)

• No Eleventy core code changes, this release is for minor version dependency updates on 3.x only
  • Fixes npm audit report for minimatch: #4239 via @11ty/recursive-copy@4.0.4
  • Upgrade liquidjs from 10.21 to 10.25
  • Freezes moo dependency #4240
  • Removes dev dependency rimraf
• Small improvements to HTML Relative Passthrough Copy tests

Full Changelog: v3.1.2...v3.1.5

⚠️ This immutable release failed to publish. Please use the identical Eleventy v3.1.5 instead!

⚠️ This immutable release failed to publish. Please use the identical Eleventy v3.1.5 instead!

• Installation: npm install @11ty/eleventy@canary --save-exact
• v4.0 Milestone: https://github.com/11ty/eleventy/milestone/46?closed=1
• Commit log (from last canary): v4.0.0-alpha.5...v4.0.0-alpha.6

Bug Fixes

• Breaking (very low-risk): Fixes #2766. Changes how boolean attributes are rendered in the HTML Base plugin (and other plugins using the HTML Transformer API). e.g. <input disabled> now outputs as <input disabled> instead of <input disabled="">
• Fixes #4188 bug with setLiquidOptions addding global data by @paulrobertlloyd in #4189
• Fixes #4187 canary bug with CDATA wrapper on Markdown files
• Fixes #4191 error with Eleventy layout resolution without file extensions (when key conflicted with a directory name in the includes or layouts folders)
• Fixes #1645 issue with JavaScript 11ty.js templates that assign data or render callbacks using Public class fields
• Fixes #3536 using content in data cascade with eleventyConfig.setFreezeReservedData(false) should not supersede content when rendering upstream Eleventy Layouts.

Dependency Updates

• Breaking (medium risk): Swap to use the dependency-updated pre-release of the 11ty fork of Nunjucks, see @11ty/nunjucks. If you’re relying on the nunjucks package in your project (and did a bad by not installing it into your dependencies), you can swap that code to use @11ty/nunjucks (or less desirably npm install nunjucks into your project’s dependencies).
• Breaking (low-risk): Upgrades to @11ty/recursive-copy@5 from @4 #4192. Affects glob parsing in passthrough copy via minimatch dependency upgrade, if you see issues please look at the relevant changelog
• Swap from please-upgrade-node to @11ty/node-version-check
• Upgrade to @11ty/eleventy-dev-server@3.0.0-alpha.6

Dependency Watch

Read more at the 📮 Eleventy Core Dependency Watch (2025 Edition)

Stats compiled on December 11, 2025 from https://node-modules.dev/ (using pnpm)

Contributors

• @paulrobertlloyd

• Breaking: removes data deep merge opt-out. eleventyConfig.setDataDeepMerge(false) now throws an error #3937 Relevant docs: https://www.11ty.dev/docs/data-deep-merge/
• Breaking: change jsTruthy: true in default liquidjs options #3507
• Breaking: change Liquid default parameter parsing to builtin instead of legacy #2679 Escape hatch to disable here: https://www.11ty.dev/docs/languages/liquid/#shortcode-parameter-parsing
• Using npm Trusted Publishers
• Minor build performance improvement in TemplateMap #3939
• Fixes issue with Markdown triple-backtick code blocks in a markdown template used in a Markdown layout #3954
• Setting markdownTemplateEngine: "md" shows a debug warning (and is aliased to false) #3925
• Fix paired shortcodes in Nunjucks macros #2261
• Improved error messaging for dynamicPermalink: false and non-string permalink values #838
• Fixes: files ignored via the preprocessor API were still populating collections keys (though the collection would be empty) #3933
• Fixes bug with Configuration API for ignores were not respected when using absolute paths for input directory #3896
• Fixes bug with single character directory names when using filePathStem #3932
• Fixes canary-only bug with Computed Data callbacks that assign variables #3917
• Feature: memoize date: git Last Modified and date: git Created options, adds JavaScript exports for these utilities to use them in your own JavaScript #3959
• Fix bug with ESM dependencies hot reloading #3899
• Move away from git:// protocol in package.json repository->url #4151
• page, eleventy, and collections are now accessible inside of Liquid {% render %} tags #1541

Dependencies

• Major dependency bump @sindresorhus/slugify from v2 to v3 (not breaking, already at Node 20+ minimum) #3942
• Major dependency bump chokidar from v4 to v5 (Breaking: Node 20.19+ minimum) #4185
• Bump liquidjs to 10.24 #3957 #3961
• Bump tinyglobby to 0.2.15 #3934
• Progress on reducing entities duplication #4154

Milestone: https://github.com/11ty/eleventy/milestone/46?closed=1
Full Changelog: v4.0.0-alpha.4...v4.0.0-alpha.5

• Fixes --watch and --serve chokidar issue with root (e.g. ".") input directories #3914

Milestone: https://github.com/11ty/eleventy/milestone/46?closed=1
Full Changelog: v4.0.0-alpha.3...v4.0.0-alpha.4

• Fixes chokidar globbing issue with globs that aren’t using * or ** #3910

Milestone: https://github.com/11ty/eleventy/milestone/46?closed=1
Full Changelog: v4.0.0-alpha.2...v4.0.0-alpha.3