
Netlify Image Cdn
This guides Claude through Netlify's built-in image transformation endpoint that lives at `/.netlify/images` on every site. You'll want this when you need to serve optimized, responsive images without standing up separate infrastructure. It covers the query parameters for resizing and format conversion, how to allowlist remote images in your config, and some smart redirect patterns for creating clean URLs like `/img/thumb/photo.jpg` instead of exposing query strings. The real value is in the composability: the source shows how to wire up Functions and Blobs for user uploads, then pipe everything through the CDN for automatic optimization and edge caching. No separate service to configure or pay for.
- skills.sh installs
- 3.3K
- GitHub stars
- 51
- last updated
- Aug 21, 2026
Install
$ npx -y skills add netlify/context-and-tools --skill netlify-image-cdn --agent claude-codeInstalls into .claude/skills of the current project.
Files
Netlify Image CDN
Transform images by requesting the endpoint with a url query parameter. This is the current and only documented surface — there is no legacy form.
GET /.netlify/images?url=<source>[&w=][&h=][&fit=][&position=][&fm=][&q=]
# resize a deployed image to 50px wide
curl -vs 'https://mysitename.netlify.app/.netlify/images?url=/owl.jpeg&w=50'
url is required; all other parameters are optional.
Query parameters
| Parameter | Purpose | Values | Default |
|---|---|---|---|
url | Source asset (required) | Relative path or remote URL | — |
w | Width in pixels | Integer | — |
h | Height in pixels | Integer | — |
fit | Resize behavior | contain, cover, fill | contain |
position | Crop anchor when fit=cover | top, bottom, left, right, center | center |
fm | Output format | avif, jpg, png, webp, gif, blurhash | content-negotiated |
q | Quality for lossy output | Integer 1–100 | 75 |
Common transformations
Sponsors
Details
- Repository
- github.com/netlify/context-and-tools
- Categories
- Frontend Development, Backend & APIs, Documentation, Cloud & Infrastructure
- First seen
- Jun 3, 2026