Modern Image Formats
This plugin adds WebP and AVIF support for media uploads within the WordPress application. By default, AVIF images will be generated if supported on the hosting server, otherwise WebP will be used as the output format. When both formats are available, the output format can be selected under Settings
About this tool.
This plugin adds WebP and AVIF support for media uploads within the WordPress application. By default, AVIF images will be generated if supported on the hosting server, otherwise WebP will be used as the output format. When both formats are available, the output format can be selected under Settings > Media . Modern images will be generated only for new uploads, pre-existing images will only converted to a modern format if images are regenerated. Images can be regenerated with a plugin like Regenerate Thumbnails or via WP-CLI with the wp media regenerate command .
By default, only modern image format sub-sizes will be generated for JPEG or PNG uploads – only the original uploaded file will still exist as a JPEG/PNG image, generated image sizes will be WebP or AVIF files. To change this behavior, there is a checkbox in Settings > Media “Output fallback images” that – when checked – will result in the plugin generating both the original format as well as WebP or AVIF images for every sub-size (noting again that this will only affect newly uploaded images, i.e. after making said change).
This plugin was formerly known as WebP Uploads.
Getting started.
Installation from within WordPress
- 01Visit Plugins > Add New .
- 02Search for Modern Image Formats .
- 03Install and activate the Modern Image Formats plugin.
Manual installation
- 04Upload the entire webp-uploads folder to the /wp-content/plugins/ directory.
- 05Visit Plugins .
- 06Activate the Modern Image Formats plugin.
After activation
- 07Visit the Settings > Media admin screen.
- 08Use the controls in the Modern Image Formats section to configure modern image formats.
Frequently asked questions.
Where can I submit my plugin feedback?
Feedback is encouraged and much appreciated, especially since this plugin may contain future WordPress core features. If you have suggestions or requests for new features, you can submit them as an issue in the WordPress Performance Team’s GitHub repository . If you need help with troubleshooting or have a question about the plugin, please create a new topic on our support forum .
