@nuxt/image
2.2.1 · 30 Oct 2026MIT817.3k / weekRepositoryHomepagenpmAtom feed
2.2.1 is the newest release of 2.x.
In short
1 removed1 security30 new17 fixed42 internal
- Removed
Remove deprecated github silent config
- 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
Release note
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
NuxtImgProps and NuxtPictureProps are 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
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.