Node 22 or newer is required. This matches Core v4. #351
The package is now ESM. This is unlikely to require any changes as the Node minimum now supports require(esm). #300
- ESM: import Image from "@11ty/eleventy-img"
- CommonJS friendly: const Image = await import("@11ty/eleventy-img")
Upgrades sharp from v0.33 to v0.35 #352, #289
- You can review the upstream v0.34 and v0.35 changelogs.

And a few breaking changes that are unlikely to affect most projects:

If you use the Transform method and set both width and eleventy:widths on the same element, note that eleventy:widths now takes priority. #314
Image.statsSync and Image.statsByDimensionsSync have been removed after being deprecated in 2024. Use the statsOnly feature instead, like so: await Image(src, { statsOnly: true, /* …options */ }). Helpful error messaging is provided if your project uses these (so don’t worry about it until you run into it, they weren’t commonly used). #211 #295
Removes the <eleventy-image> WebC component (use the transform method instead) #305

New Features

New passthrough format (usage: formats: ["passthrough"]) copies and uses the source file directly, while still adding width and height attributes to the generated output. Useful when you've already optimized your source images and want to skip the optimization pipeline — about 20× faster in local benchmarks. Example on #212. Also #133, #183, #309
New eleventy:sizes attribute allows overriding any sizes attribute in markup #306
New manualCacheKey option to improve the cropping API #271 #274 by @jens-struct

Bug Fixes

Line chart showing memory issues in v6, better performance in v5, but far improved performance in v7

Huge memory usage improvements from @sentience in #313 and @jornmineur in #302 #319 (v6 had issues, but we’ve eclipsed v5 performance with this release 🏆)
Removes the w descriptor when only one size is used in srcset, fixing valid HTML output when only one width is used and no sizes is present (#298).
Fixes eleventy:ignore appearing in output on <img> tags inside <picture> elements — by @valadaptive in #303.
Decodes HTML entities on <img src> when read back from HTML, by @kirthi-b #349 #307

Internals

Swaps the debug dependency for obug (#356).
Major version dependency upgrade: upgrades p-queue from v6.6 to v8.1. #120 This dependency became ESM-only in v7 and Node 18+ in v8.

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

This PR has been generated by Renovate Bot.

This PR contains the following updates: | Package | Type | Update | Change | |---|---|---|---| | [@11ty/eleventy-img](https://github.com/11ty/image) | dependencies | major | [`^6.0.4` -> `^7.0.0`](https://renovatebot.com/diffs/npm/@11ty%2feleventy-img/6.0.4/7.0.0) | --- ### Release Notes <details> <summary>11ty/image (@11ty/eleventy-img)</summary> ### [`v7.0.0`](https://github.com/11ty/image/releases/tag/v7.0.0): Image v7.0.0: The Memory Efficiency Release [Compare Source](https://github.com/11ty/image/compare/v6.0.4...v7.0.0) **TL;DR: ESM-only, Node 22+ minimum, and huge memory and performance wins over v6.** Thank you to [@sentience](https://github.com/sentience), [@valadaptive](https://github.com/valadaptive), [@kirthi-b](https://github.com/kirthi-b), [@jens-struct](https://github.com/jens-struct), and [@jornmineur](https://github.com/jornmineur) for their contributions to this release! Issue Milestone: https://github.com/11ty/eleventy-img/milestone/25?closed=1 Full Changelog: [v6.0.4...v7.0.0](https://github.com/11ty/image/compare/v6.0.4...v7.0.0) #### Breaking changes - Node 22 or newer is required. This matches Core v4. [#351](https://github.com/11ty/image/issues/351) - The package is now ESM. This is unlikely to require any changes as the Node minimum now supports `require(esm)`. [#300](https://github.com/11ty/image/issues/300) - ESM: `import Image from "@11ty/eleventy-img"` - CommonJS friendly: `const Image = await import("@11ty/eleventy-img")` - Upgrades sharp from v0.33 to v0.35 [#352](https://github.com/11ty/image/issues/352), [#289](https://github.com/11ty/image/issues/289) - You can review the upstream [v0.34](https://sharp.pixelplumbing.com/changelog/#v0340---4th-april-2025) and [v0.35](https://github.com/lovell/sharp/releases/tag/v0.35.0) changelogs. And a few breaking changes that are unlikely to affect most projects: - If you use the Transform method and set both `width` and `eleventy:widths` on the same element, note that `eleventy:widths` now takes priority. [#314](https://github.com/11ty/image/issues/314) - `Image.statsSync` and `Image.statsByDimensionsSync` have been removed after being deprecated in 2024. Use the `statsOnly` feature instead, like so: `await Image(src, { statsOnly: true, /* …options */ })`. Helpful error messaging is provided if your project uses these (so don’t worry about it until you run into it, they weren’t commonly used). [#211](https://github.com/11ty/image/issues/211) [#295](https://github.com/11ty/image/issues/295) - Removes the `<eleventy-image>` WebC component (use the transform method instead) [#305](https://github.com/11ty/image/issues/305) #### New Features - New passthrough format (usage: `formats: ["passthrough"]`) copies and uses the source file directly, while still adding width and height attributes to the generated output. Useful when you've already optimized your source images and want to skip the optimization pipeline — about 20× faster in local benchmarks. [Example on #212](https://github.com/11ty/image/issues/212#issuecomment-5076153507). Also [#133](https://github.com/11ty/image/issues/133), [#183](https://github.com/11ty/image/issues/183), [#309](https://github.com/11ty/image/issues/309) - New `eleventy:sizes` attribute allows overriding any `sizes` attribute in markup [#306](https://github.com/11ty/image/issues/306) - New `manualCacheKey` option to improve the cropping API [#271](https://github.com/11ty/image/issues/271) [#274](https://github.com/11ty/image/issues/274) by [@jens-struct](https://github.com/jens-struct) #### Bug Fixes <img width="622" height="399" alt="Line chart showing memory issues in v6, better performance in v5, but far improved performance in v7" src="https://github.com/user-attachments/assets/230f3267-866f-4789-9ac4-66f60670110b" /> - Huge memory usage improvements from [@sentience](https://github.com/sentience) in [#313](https://github.com/11ty/image/issues/313) and [@jornmineur](https://github.com/jornmineur) in [#302](https://github.com/11ty/image/issues/302) [#319](https://github.com/11ty/image/issues/319) (v6 had issues, but we’ve eclipsed v5 performance with this release 🏆) - Removes the `w` descriptor when only one size is used in srcset, fixing valid HTML output when only one width is used and no sizes is present ([#298](https://github.com/11ty/image/issues/298)). - Fixes `eleventy:ignore` appearing in output on `<img>` tags inside `<picture>` elements — by [@valadaptive](https://github.com/valadaptive) in [#303](https://github.com/11ty/image/pull/303). - Decodes HTML entities on `<img src>` when read back from HTML, by [@kirthi-b](https://github.com/kirthi-b) [#349](https://github.com/11ty/image/issues/349) [#307](https://github.com/11ty/image/issues/307) #### Internals - Swaps the debug dependency for obug ([#356](https://github.com/11ty/image/issues/356)). - Major version dependency upgrade: upgrades p-queue from v6.6 to v8.1. [#120](https://github.com/11ty/image/issues/120) This dependency became [ESM-only in v7](https://github.com/sindresorhus/p-queue/releases/tag/v7.0.0) and [Node 18+ in v8](https://github.com/sindresorhus/p-queue/releases/tag/v8.0.0). </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).

renovate-bot added 1 commit

2026-10-09 18:01:43 +02:00

Update dependency @11ty/eleventy-img to v7

CI / build (push) Successful in 34s

Details

CI / lint (push) Successful in 35s

Details

e6bf7abc23

renovate-bot requested review from robbevp

2026-10-09 18:01:43 +02:00

renovate-bot force-pushed renovate/11ty-eleventy-img-7.x from e6bf7abc23

CI / build (push) Successful in 34s