URL Structure
Assets are served with the following URL pattern:Asset URLs are versioned and include cache control headers for optimal performance.
Dynamic Transformations
Image transformations can be applied via URL parameters on any CDN image URL:How It Works
- When transformation parameters are detected, the CDN automatically redirects (302) to a transformation endpoint
- The transformed image is cached at the CDN edge for subsequent requests
- You can directly access the transformation endpoint by prefixing
/transform/to the path (bypasses redirect)
Transformation Parameters
| Parameter | Description | Values | Example |
|---|---|---|---|
w | Width in pixels | 1-4096 | w=800 |
h | Height in pixels | 1-4096 | h=600 |
fit | Resize mode | cover, contain, inside, outside, fill | fit=cover |
q | Quality | 1-100 | q=80 |
fm | Output format | jpeg, jpg, png, webp, avif, tiff, gif | fm=webp |
blur | Blur intensity | 0-100 | blur=10 |
dpr | Device pixel ratio (retina) | 0.5-3 | dpr=2 |
crop | Crop mode | Various crop parameters | crop=... |
Examples
Resize for Thumbnails
Convert to WebP with Quality
Retina Display Support
Apply Blur Effect
Fit Modes
- cover
- contain
- inside
- outside
- fill
Scales the image to fill the target dimensions. May crop parts of the image.Best for: Hero images, backgrounds, thumbnails where filling space is important.
Format Selection Guide
| Format | Best For | Pros | Cons |
|---|---|---|---|
webp | General web use | Small file size, wide support | Not supported in older browsers |
avif | Maximum compression | Smallest files, excellent quality | Limited browser support |
jpeg | Photographs | Universal support, good compression | No transparency |
png | Graphics with transparency | Lossless, transparency support | Larger file sizes |