Image delivery
Use the asset’s absolute url, which points to /images/<path> for image MIME types. /images only accepts images; non-image content returns HTTP 415. Use file delivery for PDFs and other files.
Request controls
| Parameter | Purpose |
|---|---|
w | Requested width in pixels. Omitted by default. |
h | Requested height in pixels. Omitted by default. |
q | Requested encoding quality for JPEG, PNG, and WebP; ignored for GIF. Defaults to 90; omitted, zero, or unparsable values use 90. |
f | Requested output format: gif, jpeg, jpg, png, or webp. Values must be lowercase; unsupported values are ignored. Defaults to JPEG for raster images. |
download=1 | Request attachment delivery. Other values or omission use inline delivery. |
For example, append ?w=640 to an image delivery URL to request a smaller presentation. Check the returned image dimensions and content type in your application. The service may further reduce large responses; a requested dimension is not a guarantee about every resulting file.
Parameters can be combined: ?w=640&h=480&q=80&f=jpeg requests a 640-by-480 bounding box and JPEG encoding at quality 80. Resizing preserves the aspect ratio and pads unused space with white.
SVGs are returned unchanged unless a supported f value is supplied; without it, w, h, and q do not transform the SVG. Supplying f requests rasterization.
The response Content-Type matches the encoded output. f=jpg is an alias for f=jpeg and returns image/jpeg. PNG, WebP, and GIF preserve source transparency; JPEG uses a white background. Size-reduction retries retain the selected format.
Use /files/<path> when preserving original image bytes is required; /images can transform images even without query parameters. Do not use transformed previews as your archival copy. Verify transparency, aspect ratio, and browser rendering for your actual image types.
Access and caching
Image delivery is separate from authenticated Studio editing. A copied delivery URL can be shared and cached. Do not assume that removing a member immediately invalidates every previously copied file URL.
See assets and asset organization.