Image Transforms

Every image you host on img.pro gets a shareable link. Add a few query parameters and the link delivers a transformed view — converted to a different format, color-corrected, blurred or sharpened, rotated, with the background removed, or with EXIF stripped. No re-uploading, no extra storage.

How It Works

Your upload response includes a canonical link field. The page renders the image and respects any transform params you put on the URL:

text

https://img.pro/abc123

Append query parameters to transform what the page renders:

text

https://img.pro/abc123?format=webp&brightness=1.1

The first request runs the transform at the nearest edge node; every request after that is served from cache (~5ms worldwide). One source image, unlimited variants — each unique URL is cached independently.

Format

Append ?format= to convert on the fly:

Value	Format	Best for
`?format=webp`	WebP	Best balance of quality and size (recommended)
`?format=avif`	AVIF	Smallest files, widening browser support
`?format=jpg`	JPEG	Universal compatibility
`?format=png`	PNG	Lossless, transparency
`?format=gif`	GIF	Email, forums, anywhere universal animation support matters

text

# Convert a JPEG upload to WebP
https://img.pro/abc123?format=webp

# Convert and lift the brightness slightly
https://img.pro/abc123?format=avif&brightness=1.1

Color & Tone

Tweak brightness, contrast, gamma, and saturation. Each is a decimal multiplier centered at 1 (no change). Omit the param to leave the channel untouched.

Param	Range	What it does
`brightness`	0 – 10	Multiplier. `1` = unchanged, `0` = pure black, `2` = twice as bright. Useful range: ~0.5 to ~2.
`contrast`	0 – 10	Multiplier. `1` = unchanged, `0` = flat mid-gray, `>1` = punchier. Useful range: ~0.7 to ~2.
`gamma`	0 – 10	Multiplier. `0` and `1` = unchanged, `<1` lightens midtones, `>1` darkens midtones. Useful range: ~0.5 to ~2.5. (Direction is opposite of what some image editors call "gamma".)
`saturation`	0 – 10	Multiplier. `1` = unchanged, `0` = grayscale, `>1` = vivid. Useful range: ~0.5 to ~2.

Cloudflare Images doesn't enforce upper bounds on these multipliers. Our 0–10 cap is editorial — it keeps cache cardinality bounded and stops you from rendering visually useless extremes. The "Useful range" column above is a guide; values outside it are legal but tend toward degenerate output.

text

# Slight brightness lift, classic web tweak
https://img.pro/abc123?brightness=1.1&contrast=1.05

# Black and white
https://img.pro/abc123?saturation=0

# Faded vintage look
https://img.pro/abc123?contrast=0.85&saturation=0.7&gamma=1.15

Blur

Apply a gaussian blur. Useful for hero overlays, placeholder images, or privacy masking.

Param	Range	Description
`blur`	0 – 250 (default 0)	Gaussian blur radius in pixels. 10–20 for subtle, 40+ for heavy. `0` = no blur (same as omitting the param).

text

# Subtle blur for a hero background
https://img.pro/abc123?blur=15

# Heavy blur for a placeholder
https://img.pro/abc123?blur=80

Sharpen

Enhance fine detail with an unsharp-mask. Subtle values fix slightly soft photos; high values can introduce ringing on smooth areas.

Param	Range	Description
`sharp`	0 – 10	Intensity. 1–3 subtle, 4–6 noticeable, 7+ aggressive.

text

# Subtle sharpen
https://img.pro/abc123?sharp=2

# Noticeable detail boost
https://img.pro/abc123?sharp=5

Orientation

Rotate or mirror without re-uploading. Rotation is lossless for the supported angles.

Param	Values	Description
`rotate`	`90`, `180`, `270`	Clockwise rotation in degrees. Other values are silently ignored.
`flip`	`h`, `v`, `hv`	Mirror horizontally, vertically, or both.

text

# Fix a sideways photo (rotate 90° clockwise)
https://img.pro/abc123?rotate=90

# Mirror horizontally
https://img.pro/abc123?flip=h

# Combine: rotate then flip
https://img.pro/abc123?rotate=180&flip=v

Background

Remove the background with a single param, optionally fill it with a solid color. Background removal uses an image-segmentation model running on the edge.

Param	Values	Description
`segment`	`foreground`	Replace the background with transparency (output as PNG to preserve the alpha channel).
`background`	CSS named color, hex (`#aabbcc` — URL-encode `#` as `%23`), `rgb(r,g,b)`, or `rgba(r,g,b,a)`. Default `#FFFFFF` (white).	Fill the background. Use after `segment=foreground` to swap the background; on its own, fills any transparent pixels in the source.

text

# Remove the background, output transparent PNG
https://img.pro/abc123?segment=foreground&format=png

# Remove the background and replace with white (Amazon / Shopify ready)
https://img.pro/abc123?segment=foreground&background=white&format=jpg

# Fill an existing transparent PNG with light gray
https://img.pro/abc123?background=%23f5f5f5

background takes URL-encoded hex (%23aabbcc), CSS named colors (white, black, navy, etc.), or rgb(...) / rgba(...) functions (URL-encode the parens if needed). For photos with people or products, pair it with segment=foreground for clean cutouts.

Privacy

Control what EXIF/metadata travels with the image. Cameras and phones embed GPS coordinates, device info, and timestamps; strip them before sharing.

Param	Values	Description
`metadata`	`copyright` (default)	Keep copyright/author tags only; strip GPS and device info. This is what you get when `?metadata=` is omitted.
	`none`	Strip everything (GPS, camera, timestamps, software). Recommended for any photo before public sharing.
	`keep`	Pass all original metadata through, including GPS coordinates and device info. Use deliberately.

text

# Strip all EXIF before sharing a phone photo
https://img.pro/abc123?metadata=none

# Keep only copyright/author tags
https://img.pro/abc123?metadata=copyright

Combining Transforms

Chain parameters freely. Order doesn't matter — the CDN runs everything in a single pass:

text

# WebP with a touch of warmth
https://img.pro/abc123?format=webp&brightness=1.05&saturation=1.1

# Faded social card
https://img.pro/abc123?format=jpg&contrast=0.9&saturation=0.8

# Privacy-blurred preview with EXIF stripped
https://img.pro/abc123?blur=40&metadata=none

# Cutout product photo on a white background
https://img.pro/abc123?segment=foreground&background=white&format=jpg

# Rotated, sharpened, exported to AVIF
https://img.pro/abc123?rotate=90&sharp=3&format=avif

Tool Pages

Most query-param operations also have dedicated tool pages — drag-and-drop landing pages that produce a downloadable result without typing any URL. They're best when you want a permanent file to download or share, rather than an inline transform on an existing link:

Remove background — one-click background removal with a download
HEIC to JPG, WebP to JPG, PNG to WebP — format converters
Blur, Sharpen, Grayscale — one-click filters
Rotate, Flip — orientation fixes
Strip EXIF, Add background color — cleanup operations

Tool pages are best for one-off downloads where you want the file directly. The query params above are best for inline embeds, OG previews, and anywhere the same source image needs many variants.

Caching & Performance

Each unique URL is cached independently at 300+ edge locations
Cache hit: ~5ms from the nearest data center
Cache miss: 50–200ms (transform + cache)
Invalid parameter values are silently ignored — the image still loads
Images are never enlarged beyond their original dimensions

Supported Formats

Transformable: JPEG, PNG, GIF, WebP, AVIF, HEIC

Served as-is: SVG, BMP, ICO (transforms are ignored, file is served directly)