Cloudflare Images Skill Reference
Cloudflare Images is an end-to-end image management solution providing storage, transformation, optimization, and delivery at scale via Cloudflare's global network.
Quick Decision Tree
Need to:
- Transform in Worker? → api.md (Workers Binding API)
- Upload from Worker? → api.md (REST API)
- Upload from client? → patterns.md (Direct Creator Upload)
- Set up variants? → configuration.md
- Serve responsive images? → patterns.md
- Add watermarks? → patterns.md
- Fix errors? → gotchas.md
Reading Order
For building image upload/transform feature:
- configuration.md - Setup Workers binding
- api.md - Learn transform API
- patterns.md - Direct upload pattern
- gotchas.md - Check limits and errors
For URL-based transforms:
- configuration.md - Create variants
- api.md - URL syntax
- patterns.md - Responsive patterns
For troubleshooting:
- gotchas.md - Error messages
- gotchas.md - Size/format limits
Core Methods
| Method | Use Case | Location |
|---|---|---|
env.IMAGES.input().transform() |
Transform in Worker | api.md:11 |
REST API /images/v1 |
Upload images | api.md:57 |
| Direct Creator Upload | Client-side upload | api.md:127 |
| URL transforms | Static image delivery | api.md:112 |
In This Reference
- api.md - Complete API: Workers binding, REST endpoints, URL transforms
- configuration.md - Setup: wrangler.toml, variants, auth, signed URLs
- patterns.md - Patterns: responsive images, watermarks, format negotiation, caching
- gotchas.md - Troubleshooting: limits, errors, best practices
Key Features
- Automatic Optimization - AVIF/WebP format negotiation
- On-the-fly Transforms - Resize, crop, blur, sharpen via URL or API
- Workers Binding - Transform images in Workers (2026 primary method)
- Direct Upload - Secure client-side uploads without backend proxy
- Global Delivery - Cached at 300+ Cloudflare data centers
- Watermarking - Overlay images programmatically