Image Transformations

One URL.
Any image you need.

Resize, crop, reformat, and optimise images on-the-fly by appending simple query parameters to any Tuzzle delivery URL. No preprocessing pipeline. No extra API calls. Just the URL.

Start for free How it works

URL structure

The anatomy of a transform URL

delivery URL
https://cdn.tzzl.io/spaces/acme/portrait.jpg?w=800&h=600&f=webp&q=85&r=fill&g=face
wOutput width in pixels
hOutput height in pixels
fOutput format

Transform modes

Every mode explained

Resize `?r=...`

scale

Proportional scale to fit width/height. Preserves aspect ratio.

fit

Fit within the bounding box, letterboxed if needed.

fill

Fill the box, cropping to maintain aspect ratio.

crop

Hard crop to exact dimensions.

thumb

Smart thumbnail optimised for face/object detection.

Gravity `?g=...`

auto

Smart gravity. Tuzzle picks the most visually interesting region.

face

Center on a detected face. Falls back to auto if no face found.

faces

Frame to include all detected faces.

eyes

Zoom to eye level for portraits.

center

Crop from the center. Classic fallback.

north/south/east/west

Crop from a fixed compass direction.

Format `?f=...`

webp

Lossy or lossless. Best for web. ~30% smaller than JPEG.

avif

AV1 Image Format. Best compression. ~50% smaller than JPEG.

jpeg

Universal compatibility. Best for photos.

png

Lossless. Best for graphics with transparency.

gif

Animated GIFs preserved. Convert video frames to GIF.

tiff

High-fidelity archival. For print and pro workflows.

Parameters

Full parameter reference

Param	Type	Description	Example
`w`	number	Output width in pixels	`w=800`
`h`	number	Output height in pixels	`h=600`
`f`	enum	Output format: jpeg \| png \| webp \| avif \| gif \| tiff	`f=webp`
`q`	number	Quality 1–100 (lossy formats only)	`q=85`
`r`	enum	Resize mode: scale \| fit \| fill \| crop \| thumb	`r=fill`
`g`	enum	Gravity: auto \| face \| faces \| eyes \| center \| north \| south \| east \| west	`g=face`

Full API docs

One URL.Any image you need.