1# Cloudflare Images Skill Reference
2 
3**Cloudflare Images** is an end-to-end image management solution providing storage, transformation, optimization, and delivery at scale via Cloudflare's global network.
4 
5## Quick Decision Tree
6 
7**Need to:**
8- **Transform in Worker?** → [api.md](api.md#workers-binding-api-2026-primary-method) (Workers Binding API)
9- **Upload from Worker?** → [api.md](api.md#upload-from-worker) (REST API)
10- **Upload from client?** → [patterns.md](patterns.md#upload-from-client-direct-creator-upload) (Direct Creator Upload)
11- **Set up variants?** → [configuration.md](configuration.md#variants-configuration)
12- **Serve responsive images?** → [patterns.md](patterns.md#responsive-images)
13- **Add watermarks?** → [patterns.md](patterns.md#watermarking)
14- **Fix errors?** → [gotchas.md](gotchas.md#common-errors)
15 
16## Reading Order
17 
18**For building image upload/transform feature:**
191. [configuration.md](configuration.md) - Setup Workers binding
202. [api.md](api.md#workers-binding-api-2026-primary-method) - Learn transform API
213. [patterns.md](patterns.md#upload-from-client-direct-creator-upload) - Direct upload pattern
224. [gotchas.md](gotchas.md) - Check limits and errors
23 
24**For URL-based transforms:**
251. [configuration.md](configuration.md#variants-configuration) - Create variants
262. [api.md](api.md#url-transform-api) - URL syntax
273. [patterns.md](patterns.md#responsive-images) - Responsive patterns
28 
29**For troubleshooting:**
301. [gotchas.md](gotchas.md#common-errors) - Error messages
312. [gotchas.md](gotchas.md#limits) - Size/format limits
32 
33## Core Methods
34 
35| Method | Use Case | Location |
36|--------|----------|----------|
37| `env.IMAGES.input().transform()` | Transform in Worker | [api.md:11](api.md) |
38| REST API `/images/v1` | Upload images | [api.md:57](api.md) |
39| Direct Creator Upload | Client-side upload | [api.md:127](api.md) |
40| URL transforms | Static image delivery | [api.md:112](api.md) |
41 
42## In This Reference
43 
44- **[api.md](api.md)** - Complete API: Workers binding, REST endpoints, URL transforms
45- **[configuration.md](configuration.md)** - Setup: wrangler.toml, variants, auth, signed URLs
46- **[patterns.md](patterns.md)** - Patterns: responsive images, watermarks, format negotiation, caching
47- **[gotchas.md](gotchas.md)** - Troubleshooting: limits, errors, best practices
48 
49## Key Features
50 
51- **Automatic Optimization** - AVIF/WebP format negotiation
52- **On-the-fly Transforms** - Resize, crop, blur, sharpen via URL or API
53- **Workers Binding** - Transform images in Workers (2026 primary method)
54- **Direct Upload** - Secure client-side uploads without backend proxy
55- **Global Delivery** - Cached at 300+ Cloudflare data centers
56- **Watermarking** - Overlay images programmatically
57 
58## See Also
59 
60- [Official Docs](https://developers.cloudflare.com/images/)
61- [Workers Examples](https://developers.cloudflare.com/images/tutorials/)
62