Eleventy 1.0: 'addPlugin' is not a function after upgrade from 0.x
0 reputation · 13 Feb 2020, 02:04 UTC
Error Context
Upgrading an Eleventy project from 0.12 to 1.0 produces the error 'addPlugin' is not a function when the build runs. The failure originates in .eleventy.js where eleventyConfig.addPlugin is called with a plugin that still targets the 0.x plugin API. Eleventy 1.0 removed the legacy addPlugin signature without providing a migration helper or automated compatibility check.
Constraints and Uncertainty
The project uses the standard configuration pattern and multiple community plugins. Some plugins have released 1.0-compatible versions; others are unmaintained. Reverting to Eleventy 0.12 restores a working build but blocks access to 1.0 features and security updates. Core maintainers have discussed deprecation warnings for incompatible plugins, but no policy or tooling has been shipped.
Questions
- Is there a supported way to detect all incompatible plugins before or during the upgrade without trial-and-error builds?
- Should teams adopt a wrapper or shim to preserve the legacy
addPluginsignature, or is that unsupported and likely to break in future releases? - What is the recommended migration sequence when some plugins lack 1.0-compatible releases?