Image compression

Format

-/format/:format/

If any other image processing operation is applied, the default format is auto (see how auto works).

Alternatively, you can use the -/format/ operation to convert an image to one of the following formats:

• jpeg is a lossy image format (good compression for photos). JPEG doesn't support an alpha channel; hence you can use the setfill operation that sets a background color. All browsers support JPEG.
• png is a lossless format (good compression only for graphics) with alpha channel support. All browsers support PNG.
• webp is a modern format with more efficient compression than JPEG and with alpha channel support. It works well for all images, yet not all browsers and OSs support it.
• auto the default behavior; is an automatic image format selection based on alpha channel presenceand a client's device and browser.
• preserve returns the image in the original format if it is PNG or JPEG, otherwise coerces to PNG or JPEG. This option is useful when you need to save the image, rather than display it to the end-user.

How auto works and prioritize image formats

First, the algorithm checks the Accept header with MIME types to figure out what image format a client browser supports.

• AVIF is used as output when all the following conditions are met:
  • image/avif MIME type is supported by the client.
  • Output image resolution is under the threshold (currently 2 MPx).
• WebP is used when image/webp MIME type is supported by the client.
• PNG is used when the source image contains an alpha channel with non-opaque pixels or when the image has limited color diversity, resembling artwork.
• JPEG is used otherwise.

You can disable the selection of modern formats, specifically AVIF and WebP, for your project in the Dashboard. Alternatively, you may consider adding the -/format/preserve/ operation to a specific URL.

Note: auto works when you use primary Uploadcare storage (not S3 Bucket) and the default Uploadcare CDN domain ucarecdn.com.

400x301 png 116Kb Transparent

400x301 jpeg 16Kb Opaque

400x301 webp 15Kb Transparent, size is equal to the opaque one.

Browsers that support WebP will load this image version, while others will display JPEG or PNG instead.

Quality

-/quality/:value/

Sets output quality for lossy formats (JPEG, WebP, and AVIF). Since actual settings vary from codec to codec and, more importantly, from format to format, we provide five simple tiers that are consistent across different formats and other settings and suit most cases of image distribution.

A higher quality level will typically result in a larger output file. However, setting the quality level higher than the original level of the uploaded image won’t increase your file size.

• normal — the default behavior when no quality operation is applied. The reasonable quality for 1x pixel density.
• better — can be used to render relatively small and detailed previews. ≈125% file size compared to normal.
• best — can be used to deliver images close to their pristine quality (e.g., for artwork). ≈170% file size.
• lighter — useful when applied to relatively large images to save traffic without significant quality loss. ≈80% file size.
• lightest — highest compression ratio for high pixel ratio. ≈50% file size.

Adaptive quality

Adaptive quality could be enabled per project in the Dashboard in Delivery configure page. In this case, we analyze the output image using content-aware algorithms to determine maximum compression that won't cause noticeable visual artefacts and adjust the compression level accordingly.

Optimizing for high pixel ratios

A great approach for high pixel densities is to increase images resolution and reduce quality at the same time. Compared to just increasing quality, images will look clearer on all screens with nearly the same file size. To adjust quality, you can use lighter and lightest presets.

1x best 16Kb Blurry on retina.

1.5x lighter 14Kb

2x lightest 12Kb Perfect for all screens.

Progressive JPEG

-/progressive/yes/
-/progressive/no/

Returns a progressive image. In progressive images, data are compressed in multiple passes of progressively higher detail. This is ideal for large images that will be displayed while downloading over a slow connection allowing a reasonable preview after receiving only a portion of the data. The operation does not affect non-JPEG images; does not force image formats to JPEG.

Strip meta information

-/strip_meta/all/
-/strip_meta/none/
-/strip_meta/sensitive/

The original image often comes with additional information built into the image file. In most cases, this information doesn't affect image rendering and thus can be safely stripped from the processed images to reduce image weight. Currently, you can only keep EXIF meta information. Other storage, such as XMP or IPTC, will always be stripped when creating a new processed image version.

• all — the default behavior when no strip_meta operation is applied. No meta information will be added to the processed file.
• none — uses the EXIF from the original file. The orientation tag will be set to 1 (normal orientation).
• sensitive — uses the EXIF from the original file but skips geolocation. The orientation tag will be set to 1 (normal orientation).

If you need to restrict user access to EXIF information, please protect your images from editing.

Animated images optimization

Video files are much smaller than GIFs, without noticeable quality loss. Their delivery to end users is much faster. Gif to video operation converts animated image files, such as GIF, WebP, and HEIC, to video and transforms them on the fly. Learn more about animated images optimization.