-
Notifications
You must be signed in to change notification settings - Fork 1
Transformation Reference
John Williams edited this page Mar 18, 2026
·
1 revision
Quick reference for Cloudinary URL transformations used in Creative Asset Validator.
https://res.cloudinary.com/{cloud_name}/{resource_type}/{type}/{transformations}/{public_id}.{format}
Example:
https://res.cloudinary.com/demo/image/upload/w_300,h_250,c_fill,g_auto,f_auto,q_auto/my-campaign/hero
| Parameter | Values | Description |
|---|---|---|
w_ |
pixels | Width |
h_ |
pixels | Height |
ar_ |
ratio (e.g., 16:9) |
Aspect ratio |
c_fill |
Fill dimensions, crop excess | |
c_fit |
Fit within dimensions | |
c_limit |
Like fit, never upscale | |
c_pad |
Pad to dimensions (add background) | |
c_scale |
Force exact dimensions | |
c_crop |
Crop to exact dimensions from gravity point |
| Parameter | Description |
|---|---|
g_auto |
AI-detected focal point |
g_auto:faces |
Focus on detected faces |
g_auto:face |
Focus on single face |
g_center |
Center |
g_north |
Top center |
g_south |
Bottom center |
g_east |
Right center |
g_west |
Left center |
g_north_west |
Top-left |
g_north_east |
Top-right |
g_south_west |
Bottom-left |
g_south_east |
Bottom-right |
| Parameter | Description |
|---|---|
b_gen_fill |
AI-generated background fill |
b_blurred |
Blurred background extension (fallback) |
b_auto |
Auto-detected background color (fallback) |
b_rgb:RRGGBB |
Specific color background |
| Parameter | Values | Description |
|---|---|---|
f_auto |
Auto-select best format (WebP, AVIF) | |
f_jpg |
Force JPEG | |
f_png |
Force PNG | |
f_webp |
Force WebP | |
q_auto |
Auto quality optimization | |
q_auto:best |
Highest auto quality | |
q_auto:good |
Good auto quality | |
q_auto:eco |
Economy (smallest file) | |
q_auto:low |
Low quality (very small) | |
q_ |
1-100 | Specific quality level |
Same as image: w_, h_, c_fill, c_pad, g_auto, etc.
| Parameter | Values | Description |
|---|---|---|
so_ |
seconds or timestamp | Start offset |
eo_ |
seconds or timestamp | End offset |
du_ |
seconds | Duration |
| Parameter | Description |
|---|---|
e_accelerate |
Speed up video |
e_reverse |
Reverse playback |
e_boomerang |
Forward + reverse loop |
Extract a single frame as an image:
https://res.cloudinary.com/{cloud}/video/fetch/so_{timestamp},w_{w},h_{h},c_fill,f_jpg/{video_url}
# 300x250 Medium Rectangle
w_300,h_250,c_fill,g_auto,f_auto,q_auto
# 728x90 Leaderboard (needs gen fill from square source)
w_728,h_90,c_pad,g_auto,b_gen_fill,f_auto,q_auto:best
# 160x600 Wide Skyscraper
w_160,h_600,c_pad,g_auto,b_gen_fill,f_auto,q_auto:best
# 970x250 Billboard
w_970,h_250,c_pad,g_auto,b_gen_fill,f_auto,q_auto:best
# Feed (1:1)
w_1080,h_1080,c_fill,g_auto,f_auto,q_auto
# Feed Portrait (4:5)
w_1080,h_1350,c_fill,g_auto,f_auto,q_auto
# Stories/Reels (9:16)
w_1080,h_1920,c_pad,g_auto,b_gen_fill,f_auto,q_auto
# In-Stream (16:9)
w_1920,h_1080,c_fill,g_auto,f_auto,q_auto
# Thumbnail (16:9)
w_1280,h_720,c_fill,g_auto,f_auto,q_auto
# Channel Art
w_2560,h_1440,c_fill,g_auto,f_auto,q_auto:best
# Shorts (9:16)
w_1080,h_1920,c_pad,g_auto,b_gen_fill,f_auto,q_auto
# Social Profile (1:1)
w_400,h_400,c_fill,g_auto,f_png
# Favicon
w_32,h_32,c_fill,g_center,f_ico
# Email Signature
w_200,h_50,c_pad,g_center,b_white,f_png