@nuxt/image
2.2.1 · 30 Oct 2026MIT817.3k / weekRepositoryHomepagenpmAtom feed
Where each line stands
Plan an upgradeLatest releases
All 52 releases- 2.x · latest line
2.2.1
30 Oct 2026Summary· from the note as AI read it
Upgrade: this release fixes a security issue.
- Security
ipx: require patched ipx and restrict input formats for /_ipx route (GHSA-p5vf-pjf5-ggj3)
v2.2.1 is a security release.
Security
This release fixes a vulnerability in the
/_ipximage transformation route.ipxwas affected by an integer overflow when decoding a multi-page image, so a crafted source image could corrupt memory in the server process with a single unauthenticated request (GHSA-qf89-6xm4-66wm; our advisory for the@nuxt/imageside is GHSA-p5vf-pjf5-ggj3). Sites where an attacker cannot control any image source are not affected.@nuxt/imagenow requiresipx ^4.1.0, which rejects oversized multi-page images with a400before decoding them.ipxis an optional dependency, so after upgrading runnpm ls ipxto confirm a patched version resolves.Behaviour change:
/_ipxnow only accepts common web image formats as input (JPEG, PNG, WebP, GIF, SVG, AVIF, HEIC) and responds403to anything else, before decoding it. If you transform other formats (for example TIFF), list them with the newimage.ipx.allowedInputFormatsoption. For sources you do not fully trust, also considerimage.ipx.restrictDecoders, which blocks the decoders of every other format for the whole process.Changelog
Fixes
- Security
ipx: require patched ipx and restrict input formats for /_ipx route (GHSA-p5vf-pjf5-ggj3)
ipx: use IPXFetchHandler so
srvx/nodeis not required at runtimeipx: import
NitroRuntimeConfigfromnitropack/types
2.2.0
19 Oct 2026- Removed
directus: remove deprecated sharpen option
deps: upgrade to released ipx v4
Support nuxt v5
v2.2.0 is the next minor release.
Changelog
Enhancements
deps: upgrade to released ipx v4
Support nuxt v5
Fixes
Use explicit imports in nitro v2 server runtime
- Removed
directus: remove deprecated sharpen option
2.1.0
28 Jul 2026- Security
Stronger SVG security: SVG sanitization now always runs, regardless of optimization settings. This fixes a potential XSS vector where
svgo: falsewould return untouched SVGs. The sanitizer now removes SMIL attribute injection, foreign content (<foreignObject>,<iframe>, etc.), and unsafe URIs across all elements - Removed
Remove deprecated github silent config
Smaller bundles: IPX is now ESM-only with reduced dependency size
v2.1.0 is the next minor release.
Highlights
Nuxt Image 2.1 ships eight new image providers, a major upgrade to our image processing engine, and a bunch of fixes across existing providers.
IPX v4
Under the hood, we've upgraded to IPX v4 which brings significant improvements:
Smaller bundles: IPX is now ESM-only with reduced dependency size
- Security
Stronger SVG security: SVG sanitization now always runs, regardless of optimization settings. This fixes a potential XSS vector where
svgo: falsewould return untouched SVGs. The sanitizer now removes SMIL attribute injection, foreign content (<foreignObject>,<iframe>, etc.), and unsafe URIs across all elements New image modifiers:
opacity,brightness,saturation,hue,lightness,autoorient,dilate,erode,clahe, andlinearBetter error messages: Invalid modifier arguments now return
400errors with clear messages instead of cryptic500sCustom URL parsing: IPX now supports custom URL formats via the
parseURLoption
New Providers
This release adds support for eight new image optimization services:
Builder.io - Builder.io's Image API
Cloudflare Images - Cloudflare's dedicated image service
EdgeOne Pages - Tencent EdgeOne Pages
Flyimg - Self-hosted image resizing
imgproxy - Fast, secure image processing server
Lorem Picsum - Placeholder images for development
Supabase - Supabase Storage image transformations
Umbraco - Umbraco CMS image cropper
Provider Improvements
Directus: Added support for sharp transforms and a
keymodifier for named presetsSanity: Support for absolute URLs with automatic project/dataset extraction (#2274), and a configurable
baseURLfor custom CDN setupsAWS Amplify & Vercel:
minimumCacheTTLis now configurable
Type Exports
NuxtImgPropsandNuxtPicturePropsare now exported from the runtime, making it easier to type your own components that wrap<NuxtImg>or<NuxtPicture>(#2115).import type { NuxtImgProps, NuxtPictureProps } from '#image'Changelog
Enhancements
deps: migrate to ipx v4
provider: add EdgeOne Pages provider
imgproxy: add provider
directus: add sharp transforms &
keymodifiersanity: support absolute URLs with project and dataset extraction
awsAmplify,vercel: make
minimumCacheTTLconfigurablesanity: add configurable
baseURLoption to Sanity providerruntime: export Picture and Image props types
umbraco: add image provider
flyimg: add Flyimg built-in provider
cloudflareimages: add new provider
builderio: add Builder.io Image API provider
picsum: add Lorem Picsum placeholder image provider
supabase: add image provider
Fixes
flyimg: encode all # characters in color values
Remove duplicated
providerkey in generated image optionsnuxt-picture: align preload link type with unhead v3
umbraco: shallow clone modifiers before modifying
cloudflare: add
baseURLfor urls with no operationsnuxt-img: set
imagesrcsetpreload when densities are set w/o sizesfastly: handle absolute URLs and merge preexisting query params
ipx: merge user-defined
runtimeConfig.ipxwith defaultsdirectus: add
withoutEnlargementmodifier typeshopify: merge preexisting query params with modifiers
Reduce max-width breakpoint values by 1px
netlifyImageCdn,netlifyLargeMedia: set netlify
remote_imagesconfigDeduplicate
formatsSanitise custom provider import names
Guard access from
layer.config.imagebunny: merge query params with existing image src
Do not shadow custom provider types with builtins
nuxt-picture: allow
data-*in imgAttrsResolve
public/dir in relation torootDir
Chore
- Removed
Remove deprecated github silent config
Dependency tracking
Know when your own dependencies move
This page watches @nuxt/image. inlinr reads your package.json and keeps the same watch on every dependency you declare, then tells you only what needs you.
Advisories reach you
An email when a critical or high advisory affects a project, before the next install.
Upgrades checked first
Peer ranges, Node, ESM-only and types changes read before you bump.
Only what matters
Majors and breaking notes stay; patches and sibling bumps fold into one line.
Registry facts last checked 22 Nov 2026. Releases and advisories last read 22 Nov 2026.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.