@nuxt/image
2.2.1 · 30 Oct 2026MIT817.3k / weekRepositoryHomepagenpmAtom feed
52 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 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
2.0.0
5 Nov 2025- Breaking
⚠️ Typed providers + modifiers
- Breaking
⚠️ Use URLSearchParams as default formatter
- Breaking
⚠️ Remove unused runtime utilities and simplify code
We're excited to announce Nuxt Image v2! 🎉 This release focuses on TypeScript support, performance improvements, and better developer experience.
Highlights
Note
Nuxt Image v2 requires Nuxt 3.1+. If you're on Nuxt 3.0.x, you'll need to upgrade to at least 3.1 first.
TypeScript support
The biggest change in v2 is full TypeScript support throughout the module (#1802).
Typed providers
Image providers now use
defineProviderfor type-safe configuration:// Before (v1) export const getImage = (src, { modifiers, baseURL }) => { // ... return { url } } // After (v2) import { defineProvider } from '@nuxt/image/runtime' export default defineProvider({ getImage(src, { modifiers, baseURL }) { // Fully typed modifiers // ... return { url } } })Type-safe configuration
Module options are now fully typed. For example, providers that require a
baseURLwill enforce it at the type level in yournuxt.config.ts:export default defineNuxtConfig({ image: { provider: 'cloudinary', cloudinary: { baseURL: 'https://res.cloudinary.com/...' // TypeScript error if missing! } } })Typed composables
The
$imghelper anduseImage()composable have full type inference (#1844):const img = useImage() // Full autocomplete for modifiers const url = img('/image.jpg', { width: 300, height: 200, fit: 'cover' // TypeScript knows the valid values! })IPX v3
We've upgraded to IPX v3 (#1799) for better performance and better
sharpbinary handling. The upgrade includes automatic detection of the correctsharpbinaries for your deployment architecture.Server-side utilities
You can now use image helpers directly in Nitro server endpoints (#1473).
// server/api/og-image.ts export default defineEventHandler((event) => { const img = useImage() return { url: img('/hero.jpg', { width: 1200, height: 630, fit: 'cover' }) } })Component improvements
Template refs
<NuxtImg>now exposes the underlying<img>element via template refs:<script setup> const img = useTemplateRef('img') onMounted(() => { // Direct access to the native img element console.log(img.value.imgEl) }) </script> <template> <NuxtImg ref="img" src="/image.jpg" /> </template>Typed slots
Both
<NuxtImg>and<NuxtPicture>now have properly typed default slots.New providers
We've added two new providers:
Shopify (#1890) - for Shopify store images
export default defineNuxtConfig({ image: { provider: 'shopify', shopify: { baseURL: 'https://your-store.myshopify.com' } } })Performance
We've made several optimizations to reduce bundle size and improve runtime performance:
Better URL encoding (#1813) - Switched to
URLSearchParamsfor more reliable parameter handlingReduced runtime utilities (#1816) - Removed unused code and simplified implementations
Streamlined screen sizes (#1931) - Aligned default breakpoints with Tailwind CSS
Better layer support
Nuxt Image now properly supports custom image directories within Nuxt layers (#1880), making it easier to organize images in modular projects.
Breaking changes
Provider API
The biggest breaking change is how providers are defined. All providers now use a default export with the
defineProviderwrapper:- export const getImage = (src, { modifiers }) => { ... } + export default defineProvider({ + name: 'my-provider', + getImage(src, { modifiers }) { ... } + })If you maintain a custom provider, you'll need to update it. But you get full TypeScript support in return!
Removed providers
The deprecated
layer0andedgioproviders have been removed.URL formatters
If you have custom providers using
joinWithfor parameter formatting, you'll need to update them to use theformatterfunction withcreateOperationsGenerator. See the migration guide for details.#### Screen sizes Default screen sizes now match Tailwind CSS. We've removed `xs` (320px) and `xxl` (2560px). See the [migration guide](https://image.nuxt.com/get-started/migration#update-screen-sizes) for how to add them back if needed.
Removed utilities
We've removed several unused runtime utilities. If you were importing internal utilities directly, check if they still exist.
Upgrading
Check out our comprehensive migration guide for step-by-step upgrade instructions.
The quick version:
npm install @nuxt/image@latest
Most apps can upgrade with no code changes. If you have custom providers, you'll need to update them to use
defineProvider- see the migration guide for examples.Bug fixes
This release includes several fixes:
Preload links: Fixed preload for multiple densities with single size
Crossorigin attributes: Correct crossorigin on preload links
Provider-specific formats: AWS Amplify and Vercel providers now have proper format allow lists
Hygraph: Prevented broken image URLs
Preset sizes: Fixed preset size application when component sizes prop is undefined
Cloudflare: Don't add baseURL if there are no operations
IPX: Always use IPX provider if external baseURL is provided
Changelog
Enhancements
Add support for image helpers in nitro endpoints
deps: Upgrade to ipx v3
ipx: Log the architecture of the build
- Breaking
⚠️ Typed providers + modifiers
Add type for default nuxt-picture slots
nuxt-img: Add types for default slot
Add shopify provider
Add support for image helpers in nitro endpoints
ipx: Log the architecture of the build
cloudimage: Make baseURL optional with cdn
nuxt-img: Expose element
Support custom image dirs within layers
Strongly type $Img/useImage methods
Add type hints for provider option
Performance
nuxt-img: Call decode before swapping from placeholder
Fixes
Remove layer0 and edgio providers
Add back layer0 and edgio providers (without) tests
cloudflare: Don't add baseURL if there are no operations
ipx: Always use ipx provider if external baseURL is provided
ipxStatic: Strip repeated slashes from image path
edgio,layer0: ⚠️ Remove providers
- Breaking
⚠️ Use URLSearchParams as default formatter
nuxt-picture: Export DefaultSlotProps
aliyun: Explicitly import useRuntimeConfig
Remove layer0 and edgio providers
Add back layer0 and edgio providers (without) tests
cloudflare: Don't add baseURL if there are no operations
ipx: Always use ipx provider if external baseURL is provided
ipxStatic: Strip repeated slashes from image path
Avoid deep type instantiation
Add types to new node + shared contexts
nuxt-img: Correct preload link for multiple densities + single size
nuxt-img: Add appropriate crossorigin attribute to preload link
awsAmplify,vercel: Set allow list of formats for providers
hygraph: Prevent broken image urls
nuxt-img: Apply preset sizes when component sizes prop is undefined
Refactors
- Breaking
⚠️ Remove unused runtime utilities and simplify code
- Breaking
⚠️ Remove xs and xxl screen sizes
CI
Breaking Changes
- Breaking
⚠️ Typed providers + modifiers
- Breaking
edgio,layer0: ⚠️ Remove providers
- Breaking
⚠️ Use URLSearchParams as default formatter
- Breaking
⚠️ Remove unused runtime utilities and simplify code
- Breaking
⚠️ Remove xs and xxl screen sizes
- 1.x
1.11.2
30 Oct 2026Summary· from the note as AI read it
Upgrade: this release fixes a security issue.
- Security
ipx: require patched ipx for /_ipx route (GHSA-p5vf-pjf5-ggj3)
v1.11.1 is a security release.
Security release
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 ^2.1.2, 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.Input formats are unchanged on this release line; the mitigation is the
ipxupgrade itself.Changelog
Fixes
- Security
ipx: require patched ipx for /_ipx route (GHSA-p5vf-pjf5-ggj3)
build: run nuxt-module-build prepare in prepack
1.11.0
30 Jul 2025Add support for image helpers in nitro endpoints
ipx: Log the architecture of the build
Remove layer0 and edgio providers
Enhancements
Add support for image helpers in nitro endpoints
ipx: Log the architecture of the build
Fixes
Remove layer0 and edgio providers
Add back layer0 and edgio providers (without) tests
cloudflare: Don't add baseURL if there are no operations
ipx: Always use ipx provider if external baseURL is provided
ipxStatic: Strip repeated slashes from image path
Avoid deep type instantiation
1.10.0
18 Mar 2025imageengine: Add new modifiers
filerobot: Add new provider
NuxtImg: Do not access
propsin template
Enhancements
imageengine: Add new modifiers
filerobot: Add new provider
Fixes
NuxtImg: Do not access
propsin templateNuxtPicture: Make
img-attrsandattrsresponsive
1.9.0
8 Jan 2025nuxt-img: Add
customslot for full control of renderingamplify: Add additional modifiers
strapi5: Add new provider with formats
1.9.0 is the next minor release.
Changelog
Enhancements
nuxt-img: Add
customslot for full control of renderingamplify: Add additional modifiers
strapi5: Add new provider with formats
Performance
Remove
node-fetch-nativedependencyUse direct imports from
#app/nuxtand#imports
Fixes
prismic: Use unsplash image proxy where necessary
Set up non-default
ipxproviders ifoptions.ipxis setEmit error events from
<NuxtImg>placeholderAdd
strapi5to list of built-in providers
1.8.1
2 Oct 2024Suffix export of runtime utils with
/indexvercel: Added missing
formatsconfig & improved documentation
Fixes
Suffix export of runtime utils with
/indexvercel: Added missing
formatsconfig & improved documentation
1.8.0
29 Aug 2024cloudinary: Support reading project from absolute url
Provide runtimeConfig to
getImagehygraph: New asset management support
Changelog
Enhancements
cloudinary: Support reading project from absolute url
Provide runtimeConfig to
getImagehygraph: New asset management support
Fixes
Prevent hydration mismatch in
<NuxtImg>nuxt-picture: Check before accessing index
Mark props as not required rather than
default: undefinedHandle undefined indices more accurately
hygraph: Add back tests and refactor splitter
1.7.1
27 Aug 2024cloudinary: Map
covertolfillmodeImport runtime types from module entrypoint
Update to latest
@nuxt/module-builder
Fixes
cloudinary: Map
covertolfillmodeImport runtime types from module entrypoint
Update to latest
@nuxt/module-builderOnly add preload links on server
weserv: Map rotate operation to
ro
1.7.0
3 May 2024Allow specifying
fetchprioritywhen preloading imagesEnsure
srccomes afterloadingwhen rendering image
Enhancements
Allow specifying
fetchprioritywhen preloading images
Fixes
Ensure
srccomes afterloadingwhen rendering image
1.6.0
22 Apr 2024Configure
domainswithNUXT_IMAGE_DOMAINSnuxt-img: Add
placeholderClassprophygraph: Support new hygraph asset system
Changelog
Enhancements
Configure
domainswithNUXT_IMAGE_DOMAINSnuxt-img: Add
placeholderClassprop
Fixes
hygraph: Support new hygraph asset system
uploadcare: Omit base when resolved URL is returned
Handle
undefinedor empty image source valuesReduce warnings about
densityvalues > 2netlify: Normalise
jpegformat tojpg
1.5.0
2 Apr 2024netlify: Support
domainsoption with Netlify Image CDNOpt in to
import.meta.*propertiesDon't attempt to parse falsy values in
options.domains
Enhancements
netlify: Support
domainsoption with Netlify Image CDN
Fixes
Opt in to
import.meta.*propertiesDon't attempt to parse falsy values in
options.domains
1.4.0
5 Mar 2024Add performance feature detection markers
Support Netlify Image CDN
Add
@errorevent from<NuxtPicture>
Changelog
Enhancements
Add performance feature detection markers
Support Netlify Image CDN
Add
@errorevent from<NuxtPicture>
Fixes
ipx: Temporarily downgrade ipx/sharp
1.3.0
17 Jan 2024imagekit: Replace obsolete overlay syntax with layers
ipx: Support nuxt layers
Enhancements
imagekit: Replace obsolete overlay syntax with layers
ipx: Support nuxt layers
1.2.0
11 Jan 2024Add
hygraphproviderAdd
weservproviderAdd
caisyprovider
Enhancements
Add
hygraphproviderAdd
weservproviderAdd
caisyproviderAdd bunny provider
Fixes
Add types to ipx provider options
1.1.0
20 Nov 2023Add
sirvproviderAdd aliyun provider
Support aws amplify provider
1.0.0
19 Oct 2023- Breaking
ipx: ⚠️ Pass all options
cloudimage: Skip cdn when
srcpath is provided with protocolipx: ⚠️ Pass all options
Fixes
cloudimage: Skip cdn when
srcpath is provided with protocolipx: ⚠️ Pass all options
Type-only import of
IPXRuntimeConfigAutocomplete
<NuxtImg>loading attribute
Chore
Breaking Changes
- Breaking
ipx: ⚠️ Pass all options
- 0.7.x
0.7.0
22 Jun 2022- Breaking
⚠️ Update dependencies
- Breaking
pkg: ⚠️ Add engines field to require
node>=14.16 Cloudimage: image.nuxtjs.org/providers/cloudimage
We have updated documentation with a fresh look and Nux 3.
Alongside dependency upgrades and security and stability enhancements from unjs/ipx, this release introduces new providers:
Cloudimage: image.nuxtjs.org/providers/cloudimage
Cloudflare: image.nuxtjs.org/providers/cloudflare
Enhancements
cloudinary: Add types for options and modifiers
Cloudimage provider
twicpics: Fix modifiers and improve documentation
storyblok: Update to the new service
Layer0 provider
Cloudflare provider
Support placeholder (#477) [experimental]
Fixes
ipx: Allow overriding
baseURLregardless of router baseipx:
nuxtContextis optionalnuxt-img, nuxt-picture: Return empty object from
headwhen preload is disabledNormalize domains to hostname (resolves #486)
Documentation
Breaking Changes
- Breaking
⚠️ Update dependencies
- Breaking
pkg: ⚠️ Add engines field to require
node>=14.16
- 0.6.x
0.6.0
5 Sep 2021- Breaking
Update ipx to 0.8.x (sharp changelog)
Add contentful provider
imgix: format keys
Breaking changes
- Breaking
Update ipx to 0.8.x (sharp changelog)
Features
Add contentful provider
imgix: format keys
ipx: compatible with 0.7.x
provider: unsplash
Bug Fixes
glide: prevent adding duplicate base url
ipx: default modifiers to _
Move
ipxto optional dependencies
- 0.5.x
0.5.0
1 Jul 2021- Breaking
Prepend router base
Support alias
imagekit: add modifiers and improve docs
Breaking changes
- Breaking
Prepend router base
Features
Support alias
imagekit: add modifiers and improve docs
Validate external domains
Bug Fixes
Prepend router base
static: url encoded name included in generated ext
- 0.4.x
0.4.1 – 0.4.1717 releases without a noteShow each
- 0.4.1723 Jun 2021no note
- 0.4.1623 Jun 2021no note
- 0.4.1523 Jun 2021no note
- 0.4.142 Jun 2021no note
- 0.4.1329 May 2021no note
- 0.4.1227 May 2021no note
- 0.4.1126 May 2021no note
- 0.4.1017 May 2021no note
- 0.4.913 May 2021no note
- 0.4.828 Apr 2021no note
- 0.4.723 Apr 2021no note
- 0.4.622 Apr 2021no note
- 0.4.519 Apr 2021no note
- 0.4.410 Apr 2021no note
- 0.4.310 Apr 2021no note
- 0.4.27 Apr 2021no note
- 0.4.116 Feb 2021no note
0.4.0
15 Feb 2021- Breaking
Remove nuxt-picture wrapper
- Breaking
Screen based responsive
Remove nuxt-picture wrapper
Breaking changes
- Breaking
Remove nuxt-picture wrapper
- Breaking
Screen based responsive
Features
Remove nuxt-picture wrapper
Screen based responsive
- 0.3.x
0.3.0
3 Feb 2021- Breaking
Improved $img interface
Improved $img interface
Use ipx@0.5.x
Breaking changes
- Breaking
Improved $img interface
Features
Improved $img interface
Use ipx@0.5.x
Bug Fixes
image: use defu for options and fix default format
plugin: create static manifest for client hydration
provider: use resolvePath to resolve aliases as well
Use correct width and handle x2
Use ratio in getSizes
- 0.2.x
0.2.1
26 Jan 20210.2.0
25 Jan 2021nuxt-img: responsive prop
$img.getSources and better srcset for
<nuxt-picture>Add background prop
Features
nuxt-img: responsive prop
$img.getSources and better srcset for
<nuxt-picture>Add background prop
Allow overiding sharp options
Allow top level provider options
allow/disallow remote urls
Fix full static support
Imagekit provider implementation and tests
Support modifiers prop for components
nuxt-img: handle loading=lazy with observer
Support
NUXT_IMAGE_PROVIDERenvironment variableSupport assets using remote adapter
Support providers and presets with props
Support types for config
Bug Fixes
Add types for pick utility and fix issues with imageOptions
img: handle ststic images in with prod server target
Clean up
undefinedvaluesCleanup double slashes outside of provider runtime
Disable blur filter on custom placeholder
Do not generate multiple sizes for SVG files
Do not render image without src
Do not sent data urls to provider
Improve error readability
Merge merge presets with inline modifiers
Opacity
Parse width and height modifiers
Remove resolution server middleware
Set correct width and height for svg
Sizes as array should overwrites defaults
cloudinary: fit types, auto format & quality
module: add package name to transpile list as well
picture: call
getMetawith current argumentstwicpics: fix minor issues and adds custom operations
Reduce placeholders quality
Rename
nuxt-imagetonuxt-imgSanitize backgroun modifier
picture: show image after load
- 0.1.x
0.1.0
2 Oct 2020- 0.0.x
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.