Image Transformation

Transform images on-the-fly using query parameters. Cache headers are sent with the image for browsers to cache the image client-side.

#Example

https://backend-d32l5h6l.nhost.app/storage/o/public/example.jpg?w=800&q=90

Notice the ?w=800&q=90 at the end of the URL.

#Width

Specify width in pixels of the image. If no height (h) is specified, the image automatically calculates the height to keep the image's aspect ratio.

Query parameter: w.

Min value0
Max value8192

#Height

Specify height in pixels of the image. If no width (w) is specified, the image automatically calculates the width to keep the image's aspect ratio.

Query parameter: h.

Min value0
Max height8192

#Quality

Specify the quality of the image.

Query parameter: q.

Min value0
Max value100

#Format

Specify the preferred format of the requested image.

This parameter can be one of the following values: webp, png, jpeg, auto. When the auto value is given the image will be transformed to the webp format if the request header explicitly accepts image/webp, otherwise the default format will be returned.

Query parameter: f.

#Rounding

Give the image rounded corners

Query parameter: r.

This parameter can be either an integer or full, if the image has to be fully rounded (e.g. an avatar).

#Blur

Add a Gaussian blur to the image.

Query parameter: b.

Min value0.3
Max value1000