Loading...
Loading...
Guide for using Netlify Image CDN for image optimization and transformation. Use when serving optimized images, creating responsive image markup, setting up user-uploaded image pipelines, or configuring image transformations. Covers the /.netlify/images endpoint, query parameters, remote image allowlisting, clean URL rewrites, and composing uploads with Functions + Blobs.
npx skill4agent add netlify/context-and-tools netlify-image-cdn/.netlify/images<img src="/.netlify/images?url=/photo.jpg&w=800&h=600&fit=cover&q=80" />| Param | Description | Values |
|---|---|---|
| Source image path (required) | Relative path or absolute URL |
| Width in pixels | Any positive integer |
| Height in pixels | Any positive integer |
| Resize behavior | |
| Crop alignment (with | |
| Output format | |
| Quality (lossy formats) | 1-100 (default: 75) |
fmwebpavifnetlify.toml[images]
remote_images = ["https://example\\.com/.*", "https://cdn\\.images\\.com/.*"]# Basic optimization
[[redirects]]
from = "/img/*"
to = "/.netlify/images?url=/:splat"
status = 200
# Preset: thumbnail
[[redirects]]
from = "/img/thumb/:key"
to = "/.netlify/images?url=/uploads/:key&w=150&h=150&fit=cover"
status = 200
# Preset: hero
[[redirects]]
from = "/img/hero/:key"
to = "/.netlify/images?url=/uploads/:key&w=1200&h=675&fit=cover"
status = 200[[headers]]
for = "/uploads/*"
[headers.values]
Cache-Control = "public, max-age=31536000, immutable"