Output format

The format or f parameter enables the source image to be converted from one format to another. The values the Image API recognises are jpeg, png, webp, gif, tiff and bmp.

The source image can be any of the following image formats: gif, png, jpeg, webp, tiff and bmp.

Where no format is given the image is returned in its original format, with one exception: a transformed TIFF is returned as WebP, as most browsers cannot display TIFF.

The PNG file format is a lossless format. It does support transparency. It does not support animation.

The PNG file format is a common graphics format, often used for application assets such as logos and icons.

• Standard: coastal-landscape-with-rocky-shoreline.jpg?format=png
• Short: coastal-landscape-with-rocky-shoreline.jpg?f=png

JPEG is a lossy format. It does not support transparency or animation.

JPEG is one of the most common formats on the web. It excels at displaying photographs. See the quality parameter for controlling the quality of the image. Converting an image with transparency to JPEG replaces the transparent areas with black, unless a background colour is given.

• Standard: coastal-landscape-with-rocky-shoreline.jpg?format=jpeg
• Short: coastal-landscape-with-rocky-shoreline.jpg?f=jpeg

WebP is supported by all current major browsers. For the full list, see the WebP section on caniuse.com.

If you request the WebP format from a browser that does not support it, the image is returned in its original format instead.

• Standard: coastal-landscape-with-rocky-shoreline.jpg?format=webp
• Short: coastal-landscape-with-rocky-shoreline.jpg?f=webp

A transformed image keeps its colour profile, so colours are displayed as intended. All other metadata is removed, including EXIF camera and location data, XMP and IPTC rights information, and any embedded preview. An image delivered untouched, with no transformation parameters, keeps everything it was uploaded with.