We did it. It’s happening. After 18 alpha pre-releases and over a year of work, our very first beta release of Eleventy 3.0 is now available. We’re still working on shipping documentation for some of these features but you can try it out now on your project using:

npm install @11ty/eleventy@beta

If you’re upgrading, use the Upgrade Help plugin for automated project checks and help!

A few numbers on the best version of Eleventy yet:

(*fastest time of 3 runs bypassing cache)

🙌🏻🚨 We still need your help! 🚨🙌🏻

11ty is now operating independently, with full time development and maintenance funded by our Open Collective supporters. We need your help to keep going! We have a goal of $6000 USD recurring monthly budget. Read more about this fundraising push and head directly to our Open Collective to start your recurring contribution!

Every recurring contribution helps!

Flagship 3.0 features

1. Eleventy is now written in ESM with full support for ESM in your projects (#836): configuration, data files, 11ty.js templates, etc. For many projects this won’t be a breaking change and we’ll continue to support CommonJS too. You can read more about what ECMAScript Modules (ESM) means for Eleventy projects on the 11ty Blog.

// ESM
export default function(eleventyConfig) {}

// We’ll keep supporting CommonJS:
module.exports = function(eleventyConfig) {}

2. Supporting more package managers and runtimes: Deno, pnpm, yarn (more to come!)
3. Asynchronous configuration #614

// ESM
export default async function(eleventyConfig) {}

// CommonJS
module.exports = async function(eleventyConfig) {}

4. For-free performance improvement to built-in slugify, inputPathToUrl universal filters (via memoization) #840
5. Named config export improves consistency for plugins #3246 and set*Directory configuration API methods #1503

export default function(eleventyConfig) {
  eleventyConfig.setInputDirectory(".");
  eleventyConfig.setOutputDirectory("_site");
};

export const config = {
  dir: {
    input: ".",
    output: "_site"
  },
};

6. Virtual Templates, configuration API to add content (great for plugins, used by the new RSS plugin!) #1612

export default function(eleventyConfig) {
  eleventyConfig.addTemplate("robots.njk", "User-agent: *\nAllow: /", {
    permalink: "/robots.txt",
  });
};

7. IdAttribute plugin adds id attributes to headings for on-page anchor links (supports all template-languages) #3363

<h1>Welcome to my web site</h1> becomes <h1 id="welcome-to-my-web-site">Welcome to my web site</h1>

8. Plain-text Bundler included (via eleventy-plugin-bundle)

export default function(eleventyConfig) {
  eleventyConfig.addBundle("css"); // Adds {% css %} paired shortcode to create per-page CSS bundles
};

9. InputPath to URL plugin lets you link directly to an input file path (and we’ll output the right URL)

<a href="my-template.md">Home</a> becomes <a href="/my-template/">Home</a>

10. Use arbitrary JavaScript with the js Front Matter #2819

---js
const hello = "hi";
---
{{ hello }}

11. page.rawInput unlocks access to raw template content #1206
12. addPreprocessor configuration API to modify raw content before rendering works for file ignores and drafts #188
13. addDateParsing configuration API to add your own custom date parsing logic #867
14. eleventyDataSchema data option to validate data cascade values #879
15. Reserved Eleventy properties in data cascade are now frozen #1173
16. Support for asynchronous plugins and async-friendly addPlugin configuration API #2675
17. useLayouts option for Custom Template Languages allows opt-out of Eleventy Layouts #2830
18. renderTransforms Universal Filter will run project transforms on an arbitrary block of content (useful for RSS and other feeds) #3294
19. --incremental=filename.md on the command line #3324
20. renderContent Universal Filter now included with Render Plugin #3370

Breaking Changes and Upgrade Path

Rather than navigating this list manually, use the Upgrade Help plugin for automated project checks and upgrade help!

• Requires Node 18 or newer.
• Removes Serverless and Edge plugins.
• Use of bundled Eleventy plugins from CommonJS requires changing require("@11ty/eleventy") to await import("@11ty/eleventy") for ESM reasons. We provide helpful error messaging for this.
• pug, ejs, haml, mustache, and handlebars plugins moved from core to official plugins
• Throw errors if --config= command line file is missing #3373
• The htmlOutputSuffix feature was removed #3327
• Aliased custom templates must be declared in active formats #3302
• --formats= and --formats="" on command line means no formats (previously aliased to *) #3255
• Custom Template Language compileOptions.permalink option changed from true to "raw" #2780
• Major semver updates of dependencies:
  • js-yaml v3 to v4 Changelog
    • Better error messaging when using tabs in YAML
    • Numbers are now parsed according to YAML 1.2 spec (from 1.1)
  • @sindresorhus/slugify v2 to v3 Changelog: Node 12+, Pure ESM
  • bcp-47-normalize v1 to v2 Changelog: Pure ESM
  • dependency-graph v0.x to v1 Changelog
  • iso-639-1 v2 to v3 Changelog: Pure ESM
  • markdown-it v13 to v14 Changelog: Pure ESM, removed dist folder
• Full list of breaking changes

Minutiae

• Packages are now published using npm package provenance.
• The code base isn’t just ESM, it’s using tabs instead of spaces too 😱😈 #3098

Full Eleventy v3 Milestone (151 closed): https://github.com/11ty/eleventy/milestone/40?closed=1
Full Changelog: v2.0.1...v3.0.0-beta.1

Thank You Notes

This release would not have been possible without our community and supporters.

• To everyone that has built something with Eleventy: thank you!
• To everyone that has answered a question about Eleventy: on the Discord, on social media, in GitHub issues or discussion, at your local meetup or coffee shop: thank you!
• To everyone that attended the 11ty Conference earlier this year: thank you!
• To everyone that brought a well-intentioned complaint about something you didn’t like about Eleventy: thank you!
• To everyone that dropped a few nice words of appreciation: thank you!
• To everyone that has chipped in with their hard-earned money and made this release possible: thank you!

Thank you to @bobmonsour, @pdehaan, @Snapstromegon, @cdransf, @5t3ph, @BenDMyers, @siakaramalegos, @shivjm, @dleatherman, @darthmall, @clottman, @nachtfunke, @David-Large, Olivia Nicholson, and @mneumegen for their community contributions!

Thank you for the code contributions from @VividVisions, @mayank99, @Zearin, @chriskirknielsen, @mendhak, @fqueze, @shivjm, @rdela, @w0whitaker, @vrugtehagel, @sachac, @Snapstromegon, @alifeee, @uncenter, @Zwyx, @mayankkamboj47, @aschrab, @jgarber623, @korverdev, @mathertel, @mathieuprog, @epelc, and @Ryuno-Ki.

• Published with npm package provenance for improved auditing and security #3392
• Pre-release 3.0-compatible plugins for Pug, EJS, Handlebars, Mustache, and HAML are now available: https://github.com/11ty/eleventy-plugin-template-languages
• Upgrade Helper plugin for 3.0 now available: https://github.com/11ty/eleventy-upgrade-help
• New eleventyConfig.setLiquidParameterParsing("builtin") API provides a path forward to opt-in to Liquid’s built-in parameter parser #2679
• New renderContent Universal Filter provided by the Render Plugin allows rendering an arbitrary string of template content #3370
• Missing file name passed as --config on command line now throws an error: #3373
• Fix to deep merge objects passed to eleventyConfig.addGlobalData #3389
• Fix internal error when folks try to pass non-function to addFilter, addShortcode configuration API methods #3385
• TypeScript improvements for types in configuration API #3097
• Fix issue with error message on SIGINT server close, removes process.exit calls for a graceful stop #3361 #3375
• Fix bug with async config and manual use of RenderPlugin #3368

Full Changelog: v3.0.0-alpha.17...v3.0.0-alpha.18
Full Eleventy v3 Milestone: https://github.com/11ty/eleventy/milestone/40

🥳🥳🥳 2 issues left (150 closed) on the Eleventy 3.0.0 milestone!

We need your help!

11ty is now operating independently, with full time development and maintenance funded by our Open Collective supporters. We need your help to keep going! We have a goal of $6000 USD recurring monthly budget. Read more about this fundraising push or head directly to our Open Collective to start your recurring contribution!

• Adds new eleventyConfig.addPreprocessor API for improved drafts workflow #188 Workaround for Nunjucks macros import #3345
• New IdAttributePlugin adds id attributes to headings across multiple template syntaxes #3363
• Fix npm audit deprecation warnings from recursive-copy package #3299
• Missing layout error messaging now reports the template path #727
• Add { type: "async" } option for getShortcodes, getFilters, and getPairedShortcodes configuration API methods (#3310)
• Fix issue with more complex export in 11ty.js templates #3359
• Small tweaks to colorized terminal text
• Internals: removes multimatch dependency, swaps to already in-use micromatch 9698667
• Fix bug with Eleventy Image On-request workflow eleventyConfig.getFilter(...) is not a function #3365
• Improvements to benchmarking debug mode outputs: https://www.11ty.dev/docs/debug-performance/
  • Benchmarking logging output improvement for minimum thresholds #1570

Full Changelog: v3.0.0-alpha.16...v3.0.0-alpha.17
Full Eleventy v3 Milestone: https://github.com/11ty/eleventy/milestone/40

🥳🥳🥳 5 issues left (137 closed) on the Eleventy 3.0.0 milestone!

We need your help!

11ty is now operating independently, with full time development and maintenance funded by our Open Collective supporters. We need your help to keep going! We have a goal of $6000 USD recurring monthly budget. Read more about this fundraising push or head directly to our Open Collective to start your recurring contribution!

• Seeing a liquidjs-related project regression (outside of our test suite) in the newest minor version, temporarily reverting from 10.15 to 10.14.
  • Investigation at #3356 revealed an application code error and the revert is unnecessary!

Full Changelog: v3.0.0-alpha.14...v3.0.0-alpha.15
Full Eleventy v3 Milestone: https://github.com/11ty/eleventy/milestone/40

We need your help!

11ty is now operating independently, with full time development and maintenance funded by our Open Collective supporters. We need your help to keep going! We have a goal of $6000 USD recurring monthly budget. Read more about this fundraising push or head directly to our Open Collective to start your recurring contribution!

• BREAKING: Bump js-yaml dependency from v3 to v4 #2126
  • Full js-yaml@v4 release notes: https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md#400---2021-01-03
• New node front matter has been renamed to js and javascript (keeping backwards compatibility with previous JavaScript object literal front matter type) #2819 (node is still there, but it should be considered deprecated)
• Support for pnpm #2876
• Add support for 11ty.js in Virtual Templates: #3347
• Add support for Virtual Templates to be used as Eleventy Layouts #1612 #2307
• Memoize internal slug, slugify, and inputPathToUrl filters #840
• Improved error messaging for filters/shortcodes #3286
• Adds new eleventyConfig.getFilters eleventyConfig.getShortcodes, and eleventyConfig.getPairedShortcodes methods for plugins and custom template languages to access universal filters/shortcodes #3310
• New eleventyConfig.augmentFunctionContext config API to help with this.eleventy and this.page on shortcodes/filters in plugins #3355
• Adds eleventyConfig.addDateParsing configuration API to customize date parsing #867
• Fix regression with JavaScript dependencies cache-busting in 11ty.js Layout files #3338
• Fix regression with markdown engine simple aliases (without additional options) still using preprocessing engine #3339
• PR: replace index.d.ts with jsdoc @typedef by @mayank99 in #3349
• PR: refactor: Use ?. for terser conditionals by @Zearin in #3343

Full Changelog: v3.0.0-alpha.14...v3.0.0-alpha.15
Full Eleventy v3 Milestone: https://github.com/11ty/eleventy/milestone/40

🥳🥳🥳 5 issues left (122 solved) on the Eleventy 3.0.0 milestone!

We need your help!

11ty is now operating independently, with full time development and maintenance funded by our Open Collective supporters. We need your help to keep going! We have a goal of $6000 USD recurring monthly budget. Read more about this fundraising push or head directly to our Open Collective to start your recurring contribution!

• Adds support for --incremental=filename to start an incremental build with an explicitly defined incremental file. Major improvements to dependency mapping for incremental builds (especially with --ignore-initial) #3324
• New useLayouts option for Custom template syntax allows opt-out of Eleventy Layouts for custom template files in your addExtension definition (you don’t want Layouts on scss files) #2830
• Fixes bugs with cached second-order JavaScript dependencies (e.g. a local import in your config file) #3270
• eleventyConfig.resolvePlugin method for adding bundled-with-Eleventy plugins is now synchronous-friendly for better compatibility with RSS plugin usage: #3314 (comment)
• Breaking: Removes htmlOutputSuffix common pitfall when input and output directories are the same. Instead of renaming output files with an additional suffix, errors are now thrown when output files attempt to overwrite any input file. #3327
• eleventyConfig.quietMode now reflects --quiet CLI value #3316
• Improved error messaging for errors in: Nunjucks filters #3295 and Acorn parsing for JavaScript dependencies for --watch or --serve #3128

Full Changelog: v3.0.0-alpha.13...v3.0.0-alpha.14
Full Eleventy v3 Milestone: https://github.com/11ty/eleventy/milestone/40

🥳🥳🥳 10 issues left (107 solved) on the Eleventy 3.0.0 milestone!

We need your help!

11ty is now operating independently, with full time development and maintenance funded by our Open Collective supporters. We need your help to keep going! We have a goal of $6000 USD recurring monthly budget. Read more about this fundraising push or head directly to our Open Collective to start your recurring contribution!

• Fixes to facilitate RSS plugin updates: 80d9f98 and #3320
• Breaking: Changes custom template syntax permalink compilation default to raw #2780
• Breaking: Removes advanced filters option in HTML <base> plugin to rename Universal Filters for this plugin (htmlBaseUrl, addPathPrefixToFullUrl, and transformWithHtmlBase). Renaming filters in this plugin will cause cross-plugin compatibility issues in other places in your project.

Full Changelog: v3.0.0-alpha.12...v3.0.0-alpha.13
Full Eleventy v3 Milestone: https://github.com/11ty/eleventy/milestone/40

We need your help!

11ty is now operating independently, with full time development and maintenance funded by our Open Collective supporters. We need your help to keep going! We have a goal of $6000 USD recurring monthly budget. Read more about this fundraising push or head directly to our Open Collective to start your recurring contribution!

Quick follow-up to fix regression introduced in v3.0.0-alpha.11 with the bundled InputPathToUrl plugin: #3319

Full Changelog: v3.0.0-alpha.11...v3.0.0-alpha.12
Full Eleventy v3 Milestone: https://github.com/11ty/eleventy/milestone/40

We need your help!

11ty is now operating independently, with full time development and maintenance funded by our Open Collective supporters. We need your help to keep going! We have a goal of $6000 USD recurring monthly budget. Read more about this fundraising push or head directly to our Open Collective to start your recurring contribution!

What's Changed

• New renderTransforms filter to execute transforms programmatically in non-HTML content (like RSS feeds) #3294
  • Included automatically with Virtual Template Feeds: 11ty/eleventy-plugin-rss#47
• Support for more extensible custom template syntaxes and aliases. #3298
  • Breaking: Aliased template syntaxes must be listed in valid formats: #3302
  • Unlocks JSX/TS/TSX/MDX templates: #3300
    • TypeScript https://www.11ty.dev/docs/languages/typescript/
    • JSX https://www.11ty.dev/docs/languages/jsx/
    • MDX https://www.11ty.dev/docs/languages/mdx/
• Some internal plugins are now unique. Multiple addPlugin calls of the same bundled plugins are de-duplicated. This is important as the RSS plugin Adds new eleventyConfig.resolvePlugin method for more ergonomic plugin import in CommonJS projects. #3314
• Bug fix: InputPathToUrl filter and plugin works with hash: thanks @mendhak! #3276
• Synchronous template write, thanks @shivjm! #3272
• Restore types in package.json, thanks @chriskirkneilsen! #3291

We need your help!

11ty is now operating independently, with full time development and maintenance funded by our Open Collective supporters. We need your help to keep going! We have a goal of $6000 USD recurring monthly budget. Read more about this fundraising push or head directly to our Open Collective to start your recurring contribution!

New Contributors

• @fqueze made their first contribution in #3275
• @mendhak made their first contribution in #3276
• @shivjm made their first contribution in #3272
• @chriskirknielsen made their first contribution in #3291

Related

Full Changelog: v3.0.0-alpha.10...v3.0.0-alpha.11
Full Eleventy v3 Milestone: https://github.com/11ty/eleventy/milestone/40

Eleventy v2.0.1 is now available! You can try it out in your project now:

npm install @11ty/eleventy@latest

• Read more about project versus global installation.

New to Eleventy?

Eleventy is a flexible and production-ready site generator known for its zero-client JavaScript footprint, speedy sites, speedy builds, and full control over the output.

• Build a blog from scratch in 6 minutes with Eleventy
• Watch The State of Eleventy in Two Minutes
• Read more about Eleventy’s project goals.

Features and Fixes

• Fixed: this.eleventy in JavaScript template functions #2790
• Fixed: lodash security audits #2877
• Fixed: pagination targets with object bracket notation #2851
• Fixed: 11ty.js templates were too aggressively cached on watch/serve #2839 #2838
• Fixed: Handlebars partials were too aggressively cached on watch/serve #2799
• Fixed: Configuration reload fixes #2864 #2869 #2867
• New: Serverless pagination now works with Arrays and Objects #2853 #2544 Learn more: https://www.11ty.dev/docs/plugins/serverless/#dynamic-slugs-to-subset-your-pagination
• Typo fixes by @deining in #2845

Housekeeping

• Full milestone/issue list: https://github.com/11ty/eleventy/milestone/43?closed=1
• Full changelog: v2.0.0...v2.0.1

Thank You Notes

This project would not be possible without our lovely community. Thank you to everyone that built something with Eleventy (×684 authors on our web site!), wrote a blog post about Eleventy, contributed code, wrote a plugins, helped with documentation, asked questions, answered questions, braved The Leaderboards, participated on Discord, filed issues, attended (or organized!) a meetup, said a kind word on social media ❤️.

• A huge thank you to Netlify, especially: @biilmann, Chris Bach, Lauren Sell (alum), and Claire Knight, without whom this release would not have been possible.
• 🏆 A special thanks to @pdehaan for their tireless contributions on the Eleventy Issue tracker.
• Yet more thanks to the all star Discord Moderators and Meetup Coordinators @BenDMyers, @clottman, @dleatherman, @darthmall, @nachtfunke, @siakaramalegos and @5t3ph.
• All of our supporters on Open Collective ❤️
• Contribute on Open Collective
• How else can you contribute to Eleventy?

Open Collective Supporters

• Gold Sponsors: Sanity.io, Nordhealth, CloudCannon, Transloadit
• Silver Sponsors: Unabridged Software, PQINA, Bejamas, Nathan Smith, Monarch Air Group, Getform.io, Mercury Jets, OCEG
• Backers: Tyler Gaw, Ariel Salminen, Peter deHaan, Melanie Sumner, Ben Nash, Alejandro Rodríguez, Mat Marquis, Philip Borenstein, Jérôme Coupé, Nicolas Hoizey, Mike Aparicio, Ben Myers, Katie Sylor-Miller, Mark Buskbjerg, mortendk, Aaron Hans, Lauris Consulting, John Meyerhofer, Todd Libby, shawn j sandy, Luke Bonaccorsi, Higby, Jenn Schiffer, Dimitrios Grammatikogiannis, Devin Clark, Eric Bailey, Manuel Matuzovic, Tim Giles, Kyosuke Nakamura, Rob Sterlini, Horacio Gonzalez, Hans Gerwitz, Makoto Kawasaki, Josh Crain, Richard Hemmer, Nick Nisi, John SJ Anderson, Ryan Swaney, Alistair Shepherd, Ivo Herrmann, Flaki, Angelique Weger, John Hall, Scott McCracken, James Steinbach, Miriam Suzanne, Bentley Davis, Ara Abcarians, vince falconi, Martin Schneider, Stephanie Eckles, Frontend Weekly Tokyo, Dorin Vancea, Chris Burnell, Ximenav Vf., Rich Holman, Kasper Storgaard, Kevin Healy, Greg Gibson, Michelle Barker, Alesandro Ortiz, David A. Herron, Paul Robert Lloyd, Andrea Vaghi, Bryan Robinson, Ashur Cabrera, Raymond Camden, John Meguerian, Joe Lamyman, Dan Ryan, Sam, Brett Nelson, Paul Welsh, Ingo Steinke, Noel Forte, Melanie Richards, Marco Zehe, Wes Ruvalcaba, Luc Poupard, Entle Web Solutions, Ken Hawkins, Fershad Irani, Nikita Dubko, Aaron Gustafson, Chris, Christian Miles, Benjamin Geese, Marcus Relacion, Netin nopeustesti, Raphael Höser, Cthos, Sia Karamalegos, Jon Kuperman, Saneef Ansari, Michel van der Kroef, Flemming Meyer, Colin Fahrion, Dan Burzo, Dan Ott, Mobilemall.pk, Cheap VPS, David Darnes, Jon Roobottom, Dana Byerly, Oisín Quinn, Renkaatsopivasti, Windesol Sähkön Kilpailutus, Luke Mitchell, SignpostMarv, THE PADDING, Bob Monsour, Richmond Insulation, Patrick Byrne, zapscribbles, Frank Reding, quinnanya, Cory Birdsong, Aram ZS, Andy Stevenson, Robin Rendle, HelppoHinta.fi, Tanner Dolby, jpoehnelt, xdesro, Alex Zappa, Richmond Concrete, Alexander Wunschik, Tom, CelineDesign, Nic Chan, Duc Lam, Stephen Bell, Robert Haselbacher, Lene, Brett DeWoody, alistairtweedie, Meta Tier List, Iva Tech, Daniel Saunders, Josh Vickerson, Dan Urbanowicz, dan leatherman, Jens Grochtdreis, CBD Review, Eric Gallager, Softermii, Eric Carlisle, Claus Conrad, Anna E. Cook, David Luhr, Matt Obee, Kiekkotorni - Nikotiinipussit