Skip to main content

filter · Image filters

Progressive JPEG (convert_jpeg_to_progressive)

Category:
Image
CoreFilters:
Yes
OptimizeForBandwidth:
Yes
Risk:
Generally safe

convert_jpeg_to_progressive converts large baseline JPEGs to progressive encoding. Progressive JPEGs render incrementally and are often smaller for images above ~10 KB.

When to use it

  • In CoreFilters, the default RewriteLevel: it runs unless you disable it.
  • Part of OptimizeForBandwidth, the level that optimizes resources without changing their URLs.
  • Also switched on by recompress_images and rewrite_images.
  • Risk rating on these docs: Generally safe.

Risks

The Image filters page lists no specific risks for this filter. If a page misbehaves with it, DisableFilters convert_jpeg_to_progressive turns it off for the scope you set it in.

Configuration

Enable it in the module configuration, at server, virtual-host or location scope:

Apache

ModPagespeedEnableFilters convert_jpeg_to_progressive

nginx

pagespeed EnableFilters convert_jpeg_to_progressive;

IIS (pagespeed.config)

pagespeed EnableFilters convert_jpeg_to_progressive

It is on by default under CoreFilters; to turn it off:

ModPagespeedDisableFilters convert_jpeg_to_progressive   # Apache
pagespeed DisableFilters convert_jpeg_to_progressive;   # nginx
pagespeed DisableFilters convert_jpeg_to_progressive   # IIS
ParameterDefaultDescription
ProgressiveJpegMinBytes10240Minimum JPEG size before converting to progressive
WebpRecompressionQuality80Quality for lossy WebP conversion
WebpAnimatedRecompressionQuality70Quality for animated WebP conversion

Scoping, ForbidFilters and the thresholds filters read: Choosing filters .

Frequently asked questions

What does the convert_jpeg_to_progressive filter do?
convert_jpeg_to_progressive converts large baseline JPEGs to progressive encoding. Progressive JPEGs render incrementally and are often smaller for images above ~10 KB.
Is convert_jpeg_to_progressive enabled by default?
Yes. convert_jpeg_to_progressive is in CoreFilters, the default RewriteLevel, so it runs unless you turn it off with DisableFilters. It is also part of the OptimizeForBandwidth level.
How do I turn off convert_jpeg_to_progressive?
Add ModPagespeedDisableFilters convert_jpeg_to_progressive on Apache or pagespeed DisableFilters convert_jpeg_to_progressive; on nginx. On IIS, add pagespeed DisableFilters convert_jpeg_to_progressive to pagespeed.config.

This page is drawn from the convert_jpeg_to_progressive entry on Image filters. Every filter in one table: PageSpeed filters.

Search