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.
One dimension: bounding
Section titled “One dimension: bounding”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.
w:320.webp — width-bound https://img.brandcenter.io/i/bc/aHVFd2tZTjRGZW5lTlh5T09RVHJmRXNFZUVobjEzdkQ/1/w:320.webp
h:160.webp — height-bound https://img.brandcenter.io/i/bc/aHVFd2tZTjRGZW5lTlh5T09RVHJmRXNFZUVobjEzdkQ/1/h:160.webp Two dimensions: an explicit box
Section titled “Two dimensions: an explicit box”w:{n},h:{n} defines a box, and fit: picks the mapping:
fit | Behavior |
|---|---|
| (absent) | Fit inside the box, aspect preserved (Uploadcare preview) |
fit:cover | Fill the box exactly, cropping overflow (Uploadcare scale_crop) |
fit:contain | Fit inside and letterbox to the exact box size |
fit:fill | Stretch to the exact box, ignoring aspect |
w:300,h:200.webp — fit inside 300×200 (default) https://img.brandcenter.io/i/bc/aHVFd2tZTjRGZW5lTlh5T09RVHJmRXNFZUVobjEzdkQ/1/w:300,h:200.webp
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 Responsive images
Section titled “Responsive images”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.)