netlify-image-cdn

Configure Netlify Image CDN transformations, remote allowlisting, and upload pipelines.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/JamesMitofsky/tag-archive --skill netlify-image-cdn-jamesmitofsky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-image-cdn
Source: https://github.com/JamesMitofsky/tag-archive/tree/main/.claude/skills/netlify-image-cdn
Command: npx skills add https://github.com/JamesMitofsky/tag-archive --skill netlify-image-cdn-jamesmitofsky

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @netlify/blobs, @netlify/functions, and includes references (resource) components.

What problem does it solve? Serving optimized, responsive images on Netlify requires knowing the /.netlify/images endpoint, its query parameters, remote-image allowlisting rules, and how to wire user uploads through Functions and Blobs — details that are easy to get wrong (404s, broken blurhash placeholders, dev-server mismatches). ## Core Features & Use Cases - On-the-fly transformations: Resize, crop, reformat (AVIF/WebP), and set quality via /.netlify/images query parameters like w, h, fit, fm, and q. - Remote image allowlisting: Configure remote_images regex patterns in netlify.toml and percent-encode source URLs to avoid 404 rejections. - Clean URL rewrites: Map friendly paths like /img/thumb/:key to transformation presets via redirect rules. - User-uploaded image pipelines: Compose Netlify Functions (upload/serve handlers) with Netlify Blobs storage and the Image CDN for a complete upload-to-optimized-delivery flow. - Use Case: Build a photo gallery where users upload images through a Function, files are stored in Blobs, and thumbnails plus hero images are served through clean rewrite URLs with automatic AVIF/WebP negotiation. ## Quick Start Ask the assistant to generate the Netlify Image CDN markup and netlify.toml configuration for serving a responsive, optimized version of a specific image on your site.

Frequently Asked Questions about netlify-image-cdn

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize images with Netlify Image CDN?

Point your img src at the /.netlify/images endpoint with a url parameter plus transformation params like w, h, fit, fm, and q. No configuration is needed for local images; Netlify auto-negotiates AVIF or WebP when fm is omitted.

How do I build a user-uploaded image pipeline on Netlify?

Combine a Netlify Function upload handler that validates type and size, Netlify Blobs for storage with strong consistency, a serve Function at /uploads/:key, and redirects mapping /img/:key to /.netlify/images for CDN transformation.

Why does /.netlify/images return 404 for remote images?

Remote sources must match a remote_images regex pattern in netlify.toml; unmatched URLs are rejected with 404. Also percent-encode the source URL in the url parameter so characters like ?, &, and = are not parsed as CDN params.

Why does /.netlify/images 404 in local development?

The endpoint is a Netlify platform feature that framework dev servers (vite, next dev, astro dev) do not provide. Run netlify dev instead, which emulates the Image CDN, allowlisting, and redirect rules locally.

Can I use fm=blurhash directly as an img src?

No. fm=blurhash returns a BlurHash text string, not image bytes, so browsers cannot render it. Fetch the string separately, decode it with a BlurHash library into a placeholder, and load the real image via a separate request without fm=blurhash.