Guide
Transformation Parameters
Resize, crop, format, and optimize images with transformation parameters.
Parameter Reference
| Parameter | Description | Example |
|---|---|---|
w, width | Maximum width in pixels | w=400 |
h, height | Maximum height in pixels | h=300 |
fit | Resize mode | fit=cover |
f, format | Output format | f=webp |
q, quality | Quality (1-100) | q=85 |
blur | Blur radius (1-250) | blur=10 |
sharpen | Sharpening (0-10) | sharpen=2 |
rotate | Rotation in degrees | rotate=90 |
flip | Flip direction | flip=h |
background | Background color (for pad fit) | background=white |
Fit Modes
| Mode | Description |
|---|---|
cover | Resize and crop to fill dimensions (default) |
contain | Resize to fit within dimensions |
scale-down | Like contain, but never enlarge |
crop | Crop to exact dimensions |
pad | Resize and pad with background color |
Output Formats
| Format | Extension | Notes |
|---|---|---|
| JPEG | f=jpeg or f=jpg | Lossy, good for photos |
| PNG | f=png | Lossless, transparency |
| WebP | f=webp | Modern, smaller size |
| AVIF | f=avif | Newest, best compression |
Flip Options
flip=h— Horizontal flipflip=v— Vertical flipflip=hv— Both
Example URLs
# Resize to 400px width, WebP format
/w=400,f=webp,q=85/example.com/photo.jpg
# Thumbnail with cover fit
/w=200,h=200,fit=cover/example.com/photo.jpg
# Rotate 90° and flip horizontally
/rotate=90,flip=h/example.com/photo.jpg
# Blur effect
/w=800,blur=15/example.com/photo.jpg
# Pad with white background
/w=400,h=400,fit=pad,background=white/example.com/photo.png