Eleventy v3.1.2 (we fixed 15 more things)

Try it out in your project

npm install @11ty/eleventy@latest

• Read more about getting started with Eleventy or why you should use Eleventy.
• Milestone: https://github.com/11ty/eleventy/milestone/50?closed=1
• Commit log (from previous stable release): v3.1.1...v3.1.2

Release notes

• Bug fix: issue with Computed Data with Array -> Object -> Template Strings #3850
• Bug fix:Workaround dependency bug in tinyglobby when using ../ for input directory (and/or passthrough copy) #3854 #3862
• Bug fix: issue with absolute path for input directory resulting in incorrect output directory #3853
• Bug fix: issue with pagination over collections missing the all collection #3860
• Bug fix: Custom template engines should inherit aliased the parent cacheable value for advanced control of internal cache (related docs). Fixes issues with JavaScript import cache busting in Windows #3824 #3832
• Bug fix: Server cache issue with newly created directory data file not picked up during --watch or --serve (on subsequent builds) #3569
• Bug fix: Saving your Configuration file may keep the process open after ⌘+C or CTRL+C #3873
• Bug fix: Incremental builds may result in templateRender has not yet initialized error after Configuration reset #3870
• Bug fix: #3874 Config reset for dev server restart
• Bug fix: #3875 #1525 numeric tags for collection names
• Audit fix: npm audit with brace-expansion dependency #3866
• Dependency update: bump entities from 6.0.0 to 6.0.1 in #3855

Eleventy v3.1.2-beta.4

Installation: npm install @11ty/eleventy@beta --save-exact
Issue Milestone: https://github.com/11ty/eleventy/milestone/50?closed=1
Commit log (from last stable): v3.1.1...v3.1.2-beta.4

• Bug Fix: #3874 Config reset for dev server restart
• Bug Fix: #3875 #1525 numeric tags for collection names

Eleventy v3.1.2-beta.3

Installation: npm install @11ty/eleventy@beta --save-exact
Issue Milestone: https://github.com/11ty/eleventy/milestone/50?closed=1
Commit log (from last stable): v3.1.1...v3.1.2-beta.3

• Bug Fix: Server cache issue with newly created directory data file not picked up during --watch or --serve (on subsequent builds) #3569
• Bug Fix: Saving your Configuration file may keep the process open after ⌘+C or CTRL+C #3873
• Bug Fix: Incremental builds may result in templateRender has not yet initialized error after Configuration reset #3870

Eleventy v3.1.2-beta.2

Installation: npm install @11ty/eleventy@beta --save-exact
Issue Milestone: https://github.com/11ty/eleventy/milestone/50?closed=1
Commit log: v3.1.1...v3.1.2-beta.2

• Custom template engines should inherit aliased the parent cacheable value for advanced control of internal cache (related docs). Fixes issues with JavaScript import cache busting in Windows #3824 #3832

Eleventy v3.1.2-beta.1

Installation: npm install @11ty/eleventy@beta --save-exact
Issue Milestone: https://github.com/11ty/eleventy/milestone/50?closed=1
Commit log: v3.1.1...v3.1.2-beta.1

• Fix issue with Computed Data with Array -> Object -> Template Strings #3850
• Workaround dependency bug in tinyglobby when using ../ for input directory (and/or passthrough copy) #3854 #3862
• Fix issue with absolute path for input directory resulting in incorrect output directory #3853
• Fix issue with pagination over collections missing the all collection #3860
• Fix npm audit with brace-expansion dependency #3866
• Bump entities from 6.0.0 to 6.0.1 by @dependabot in #3855

Eleventy v3.1.1 (we fixed some things)

Try it out in your project

npm install @11ty/eleventy@latest

Read more about getting started with Eleventy or why you should use Eleventy.

• Milestone: https://github.com/11ty/eleventy/milestone/48?closed=1
• Commit log: v3.1.0...v3.1.1

Release notes

• Fix issue with object property order when using Computed Data in a Paginated template #3849
• Fix issue with absolute paths for virtual templates #3805
• Fix pagination regression issue when paginating over configuration collections #3808 #3823 #3834 #3825
• Fix layout caching issue when using Nunjucks as preprocessing engine for Html or Markdown #3807 #3819
• Fix bug with RenderManager initialization via Render plugin #3810
• Fixes bug when using eleventyConfig.amendLibrary and eleventyConfig.setLibrary together on the same syntax type, amendLibrary would run multiple times #3816
• Fix issue with virtual templates when includes directory is set to an empty string "" #3797
• Fix issue with string eleventyComputed.permalink values when used with non-computed permalink #3818
• Fix issue with global data directory when setting input to a parent directory (e.g. "../") #3809
• Improved error messaging for invalid date values in Data Cascade #3833
• Fixes issue with duplicate entries in template dependency graph (and collections) from missing node normalization during subsequent --watch or --serve builds

Eleventy v3.1.1-beta.3

• Fixes issue with duplicate entries in template dependency graph (and collections) from missing node normalization during subsequent --watch or --serve builds

Milestone: https://github.com/11ty/eleventy/milestone/48?closed=1
Full Changelog: v3.1.1-beta.2...v3.1.1-beta.3

Eleventy v3.1.1-beta.2

• Improvement to pagination regression issue fix when recursively consuming configuration collections #3825

Milestone: https://github.com/11ty/eleventy/milestone/48?closed=1
Full Changelog: v3.1.1-beta.1...v3.1.1-beta.2

Eleventy v3.1.1-beta.1: Bug fixes!

• Fix issue with absolute paths for virtual templates #3805
• Fix pagination regression issue when paginating over configuration collections #3808 #3823 #3834 #3825
• Fix layout caching issue when using Nunjucks as preprocessing engine for Html or Markdown #3807 #3819
• Fix bug with RenderManager initialization via Render plugin #3810
• Fixes bug when using eleventyConfig.amendLibrary and eleventyConfig.setLibrary together on the same syntax type, amendLibrary would run multiple times #3816
• Fix issue with virtual templates when includes directory is set to an empty string "" #3797
• Fix issue with string eleventyComputed.permalink values when used with non-computed permalink #3818
• Fix issue with global data directory when setting input to a parent directory (e.g. "../") #3809
• Improved error messaging for invalid date values in Data Cascade #3833

Milestone: https://github.com/11ty/eleventy/milestone/48?closed=1
Full Changelog: v3.1.0...v3.1.1-beta.1

Eleventy v3.1.0: 11% faster and 22% smaller!

Try it out in your project

npm install @11ty/eleventy@latest

Read more about getting started with Eleventy or why you should use Eleventy.

• v3.1.0 Issue Milestone: https://github.com/11ty/eleventy/milestone/47?closed=1
• Compare with v3.0.0: v3.0.0...v3.1.0

What’s new?

• Support for Import Attributes #3580 e.g. import data from './data.json' with { type: 'json' };, see 11ty/eleventy-dependency-tree-esm#2 and 11ty/eleventy-dependency-tree-esm#4
• Build performance improvements over v3.0.0 in #3493
  • Improve build performance ~50ms (dynamic dev server import only on --serve) by @boehs in #3689
• Adds html-relative Passthrough Copy mode for relative asset references in HTML. Learn more at #3573 (from issue #3552)
• A whole bunch of Dev Server updates and fixes, most notably https://github.com/11ty/eleventy-dev-server/releases/tag/v2.0.7
• Add subpath export for UserConfig type definitions (#3460) by @noelforte in #3562
• IdAttribute plugin has checkDuplicates option (always enabled by default, now allows you to disable) #3560 Docs: https://www.11ty.dev/docs/plugins/id-attribute/#with-options
• Error messaging improvements:
  • Improved error messaging when attempting to link to a permalink: false template (in the HTML <base> plugin) #3503
  • Better errors with Custom template types with non-string permalink values: #3472
  • Improved error messaging with syntax errors in .11ty.js files #3571
  • Improved require(esm) error messaging to reflect proper support in Node v22.12 #3568
  • Error stack improvements by @noelforte in #3572

Bug fixes

• Bug fix for returning non-traditional data with eleventyConfig.addCollection API #3467

• Internals: consolidates TemplateMap with Dependency Graph for more accurate build order during incremental builds (fixing unrendered template errors) #3410 (Fair warning: this was a big change!)
• Fix duplicate permaink error on Windows after file delete and re-add #3631
• Fix (and better error messaging) for link.slice is not a function errors when using function permalinks #3472 #3619
• Improvements to bundler-friendiness of imports (using Programmatic API in serverless contexts) #3656
• Fix when using eleventyConfig.setUseTemplateCache(false); and 11ty.js JavaScript templates #3667
• Fix for passthrough copy output locations during incremental builds #3285
• Check Error.cause for TemplateContentPrematureUseError when rendering by @noelforte in #3651
• Fix dateValue.toLowerCase() is not a function error when using addDateParsing API #3674

• Improvements to engine consistency (improved use of Nunjucks cache) #3736
• Fixes eleventy.templateModified listeners warning #3735
• Fixes for bugs with merging Arrays in eleventyComputed. Arrays are now treated as a single entity when merging over non-computed data. Arrays will still be merged in the data cascade from multiple eleventyComputed entries. #3728
• Fix bug with collection definition on subsequent builds #3711
• HtmlBasePlugin: Fix confusing error message by @noelleleigh in #3709
• Fix import-related error with CommonJS modules in Node 23 by @vrugtehagel in #3519 #3518
• Fix for InputPathToUrl plugin to support unencoded paths with spaces #3559 #3583

Dependency Watch

Version	Production Dep Count	Production Size
v3.1.0	×142	21.4 MB
v3.0.0	×187	27.4 MB
v2.0.1	×215	36.4 MB
v1.0.2	×356	73.3 MB

• Bumps liquidjs dependency to 10.21.0 (from 10.17.0)
• Removes rifraf dependency by @jeffalo #3622 #3673
• A bunch of improvements from @e18e org folks! Upstream issue: e18e/ecosystem-issues#164
  • Dependency optimization by @outslept in #3715
  • Replace glob packages with lighter alternatives – fast-glob + is-glob -> tinyglobby, micromatch -> picomatch by @pralkarz in #3680

Major Upgrades

• @11ty/dependency-tree from v3 to v4 (bumps to Node 18+) https://github.com/11ty/eleventy-dependency-tree/releases/tag/v4.0.0
• @11ty/dependency-tree-esm from v1 to v2 (bumps to Node 18+) https://github.com/11ty/eleventy-dependency-tree-esm/releases/tag/v2.0.0
• @11ty/eleventy-utils from v1 to v2 (bumps to Node 18+) https://github.com/11ty/eleventy-utils/releases/tag/v2.0.0
• @11ty/recursive-copy from v3 to v4 (bumps to Node 18+, dependency cleanup) https://github.com/11ty/recursive-copy/releases/tag/v4.0.0
• entities from v5 to v6 (upstream change related to deep import paths https://github.com/fb55/entities/releases/tag/v6.0.0)

eleventy-benchmark Build Performance

---------------------------------------------------------
Eleventy Benchmark (Node v22.13.1, 2500 templates each)
---------------------------------------------------------
Eleventy 3.0.0                                        
---------------------------------------------------------
.liquid: ... 3 runs:          
* Median: 1.43 seconds
* Median per template: 572 µs

.njk: ... 3 runs:             
* Median: 2.03 seconds
* Median per template: 812 µs

.md: ... 3 runs:              
* Median: 1.79 seconds
* Median per template: 716 µs

---------------------------------------------------------
Eleventy 3.1.0-beta.1                                        
---------------------------------------------------------
.liquid: ... 3 runs:          
* Median: 1.3 seconds (-10%)
* Median per template: 520 µs (-10%)

.njk: ... 3 runs:             
* Median: 1.81 seconds (-11%)
* Median per template: 724 µs (-11%)

.md: ... 3 runs:              
* Median: 1.61 seconds (-11%)
* Median per template: 644 µs (-11%)

We’re showing the benchmark from the latest beta here — there were no core code changes between v3.1.0-beta.1 and v3.1.0.