brocode/module-image-optimizer-webp

Magento 2 module to optimize images to AVIF format

1.0.2 2026-05-26 10:00 UTC

Requires

• ext-gd: *
• brocode/module-image-optimizer: ^1.0

Suggests

• brocode/module-image-optimizer-avif: Additional module for AVIF image optimization

MIT

• Benjamin Rosenberger

README

📖 Full docs, design notes & production guidance: brocode.at/modules/module-image-optimizer Part of the BroCode Image Optimizer family for Magento 2.

This module provides a WEBP image converter for Magento 2. It is based on the brocode/module-image-optimizer

Requirements

• Magento 2.4.x
• Web server: nginx (the only server Adobe supports from 2.4.9; nginx 1.30). Apache config is included for older installs, but Apache was dropped from Magento's tested requirements at 2.4.8-p3 / 2.4.7-p7.
• PHP 8.3 / 8.4 (8.5 on 2.4.9)

Installation

composer require brocode/module-image-optimizer-webp
bin/magento module:enable BroCode_ImageWebpOptimizer
bin/magento setup:upgrade

Configuration

The configuration can be found under Stores -> Configuration -> Services -> BroCode ImageOptimizer -> Image Webp. Currently the image quality can be set (value between 0 and 100) and the converter can be disabled.

Apache Configuration

Add following snippet to the .htaccess file, which serves public images that are converted:

 ############################################
 ## if client accepts webp, rewrite image urls to use webp version
AddType image/webp .webp
RewriteCond %{HTTP_ACCEPT} image/webp
RewriteCond %{REQUEST_FILENAME} (.*)\.(png|gif|jpe?g)$
RewriteCond %{REQUEST_FILENAME}\.webp -f
RewriteRule ^ %{REQUEST_FILENAME}\.webp [L,T=image/webp]

Nginx Configuration

Merge into the project nginx vhost (nginx.conf.sample). Place the map in http {}; add the location before Magento's generic static location under /media/.

# In http { } (once per nginx instance or included vhost file)
map $http_accept $webp_suffix {
    default "";
    "~*webp" ".webp";
}

# In server { }
location ~* ^/media/.+\.(png|gif|jpe?g)$ {
    add_header Vary Accept;
    try_files $uri$webp_suffix $uri $uri/ /get.php$is_args$args;
}

Further Information

See base module for more informations on how to setup the image optimizer: brocode/module-image-optimizer

Module family

Module	Purpose
module-image-optimizer	Base: scan pub/media, write modern-format sidecars
module-image-optimizer-webp	WebP converter
module-image-optimizer-avif	AVIF converter
module-image-optimizer-queue	Async conversion via the Magento queue
module-image-optimizer-amqp	Async conversion over RabbitMQ/AMQP

Docs & guides: brocode.at