Skip to content

Resize (w, h, fit)

Any integer from 1 to 7200 works for w and h. The DAM’s pre-generated rendition sizes (the ladder) are the fast path — those resolve to existing files with no render at all — but you are not restricted to them: arbitrary sizes render on demand and cache at the edge.

w:{n} alone fits the image inside an n × n box; h:{n} alone makes height the binding constraint. Aspect ratio is always preserved, the other dimension is derived, and requests beyond the source clamp — no upscaling.

width-bound
w:320.webp — width-bound
https://img.brandcenter.io/i/bc/aHVFd2tZTjRGZW5lTlh5T09RVHJmRXNFZUVobjEzdkQ/1/w:320.webp
height-bound
h:160.webp — height-bound
https://img.brandcenter.io/i/bc/aHVFd2tZTjRGZW5lTlh5T09RVHJmRXNFZUVobjEzdkQ/1/h:160.webp

w:{n},h:{n} defines a box, and fit: picks the mapping:

fitBehavior
(absent)Fit inside the box, aspect preserved (Uploadcare preview)
fit:coverFill the box exactly, cropping overflow (Uploadcare scale_crop)
fit:containFit inside and letterbox to the exact box size
fit:fillStretch to the exact box, ignoring aspect
fit inside 300×200 (default)
w:300,h:200.webp — fit inside 300×200 (default)
https://img.brandcenter.io/i/bc/aHVFd2tZTjRGZW5lTlh5T09RVHJmRXNFZUVobjEzdkQ/1/w:300,h:200.webp
exact 200×200, overflow cropped
w:200,h:200,fit:cover.webp — exact 200×200, overflow cropped
https://img.brandcenter.io/i/bc/aHVFd2tZTjRGZW5lTlh5T09RVHJmRXNFZUVobjEzdkQ/1/w:200,h:200,fit:cover.webp

Build srcset from ladder rungs and let the browser choose — those are the pre-generated fast path, so every entry is a straight cache hit. The width descriptor is the true pixel width: for portrait sources that’s rung × aspectRatio, not the rung itself. (In-app, BcImageUrl.srcSetForLadder computes this for you.)