> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.aptranet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Image optimization

> Convert and compress eligible images at the edge with WebP, AVIF, quality, and PNG controls.

Image optimization can reduce transferred bytes for supported image requests. It is configured per distribution.

## Controls

| Field | Effect |
| - | - |
| Enabled | Turns image processing on for the distribution |
| WebP | Converts eligible images when the client supports WebP |
| AVIF | Converts eligible images when the client supports AVIF |
| Quality | Sets lossy output quality from 1 to 100 |
| PNG lossless | Compresses eligible PNG content without lossy conversion where applicable |

## Rollout

**1. Establish a baseline**

Record representative image sizes, visual quality, origin traffic, and cache behavior.

**2. Enable one format**

Start with WebP or AVIF on a staging distribution. Test browsers, transparent images, animated assets, and metadata expectations.

**3. Tune quality**

Compare output at the intended display sizes. Avoid judging only from thumbnails.

**4. Monitor cache variants**

Confirm the optimized format varies correctly by client capability and does not overwrite another format's cache entry.

Keep original assets at the origin so you can change output formats or quality without reconstructing source images.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.