quality
Output image quality for lossy file formats.
The quality
parameter enables control over the compression level for lossy file-formatted images.
Syntax
quality={value}quality={value},{autoWebpQuality}
value
may be any integer between 1 and 100, where 1 is a lower quality image and a smaller file and 100 is the highest quality image and larger file. If desired, a second quality level can be specified for use when auto=webp is enabled and a WebP output format has been selected.
Notes
- The
quality
parameter can be applied to the following output formats:avif
,jpg
,pjpg
,png8
,webp
andwebply
. - If no
quality
parameter is present forjpg
,pjpg
, orwebp
, the output image will be returned at the default value set in the Image Optimizer web interface. - If
auto=webp
is enabled by the URL or the service settings, the second value will be used as the quality value if the requestor sends theaccept: image/webp
request header. - When only specifying
quality
, if the output image file size is larger than the input image, the original image will be delivered. - This does not include a way of specifying auto AVIF quality.
Examples
Click the links to view the transformed image using a demo Fastly IO service.
Example usage | Description |
---|---|
?quality=85 | Output an image with quality set to 85. |
?format=pjpg&auto=webp&quality=85,75 | Convert the image format to a progressive jpg with image quality set to 85. For browsers that support WebP set the image quality to 75. |
User contributed notes
BETADo you see an error in this page? Do have an interesting use case, example or edge case people should know about? Share your knowledge and help people who are reading this page! (Comments are moderated; for support, please contact support@fastly.com)