---
title: 'Image delivery'
description: 'Use asset paths and image delivery parameters deliberately.'
---

# 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](/docs/api/files) 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](/docs/api/assets) and [asset organization](/docs/studio/asset-manager/organize-assets).


---

[View full sitemap](/docs/sitemap.md)