Optimizing converted images

The medialibrary will shave off some kilobyes of the converted images by running them through a chain of various image optimization tools.

The optimization will only be applied on converted images, the package will not modify your original files. If you want to avoid optimization of a conversion just tack nonOptimized to the conversion.

public function registerMediaConversions(Media $media = null)

The package will use these optimizers if they are present on your system:

Head over to the installation page to learn how to install these.

Which tools will do what?

The package will automatically decide which tools to use on a particular image.


JPGs will be made smaller by running them through JpegOptim. These options are used:

  • --strip-all: this strips out all text information such as comments and EXIF data
  • --all-progressive: this will make sure the resulting image is a progressive one, meaning it can be downloaded using multiple passes of progressively higher details.


PNGs will be made smaller by running them through two tools. The first one is Pngquant 2, a lossy PNG compressor. We set no extra options, their defaults are used. After that we run the image through a second one: Optipng. These options are used:

  • -i0: this will result in a non-interlaced, progressive scanned image
  • -o2: this set the optimization level to two (multiple IDAT compression trials)


SVGs will be minified by SVGO. SVGO's default configuration will be used, with the omission of the cleanupIDs plugin because that one is known to cause troubles when displaying multiple optimized SVGs on one page.

Please be aware that SVGO can break your svg. You'll find more info on that in this excellent blogpost by Sara Soueidan.


GIFs will be optimized by Gifsicle. These options will be used:

  • -O3: this sets the optimization level to Gifsicle's maximum, which produces the slowest but best results.