Modern Image Formats

Description

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.

Installation

Installation depuis WordPress

  1. Allez sur l’écran Extensions > Ajouter.
  2. Search for Modern Image Formats.
  3. Install and activate the Modern Image Formats plugin.

Installation manuelle

  1. Upload the entire webp-uploads folder to the /wp-content/plugins/ directory.
  2. Aller dans Extensions.
  3. Activate the Modern Image Formats plugin.

After activation

  1. Visit the Settings > Media admin screen.
  2. Use the controls in the Modern Image Formats section to configure modern image formats.

FAQ

Où puis-je partager mes retours d’expérience ?

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.

Où puis-je signaler des bogues de sécurité ?

L’équipe Performance et la communauté WordPress prennent au sérieux les bogues de sécurité. Nous apprécions vos efforts pour divulguer de manière responsable vos découvertes, et ferons notre possible pour reconnaître vos contributions.

Pour signaler un problème de sécurité, veuillez consulter le programme WordPress HackerOne.

Comment puis-je contribuer à l’extension ?

Contributions are always welcome! Learn more about how to get involved in the Core Performance Team Handbook.

J’ai activé le module Modern Image Formats, mais les images WebP ne sont pas toujours générées lorsque je télécharge une image JPEG. Pourquoi ?

There are two primary reasons that a WebP image may not be generated:

  1. The Modern Image Formats plugin has identified that the WebP version of the uploaded JPEG image would have a larger file size than the original JPEG image, so it does not generate the WebP version.
  2. The JPEG image was not uploaded to the Media Library. At this time, WebP versions are only generated for images to the Media Library. WebP versions are not generated for JPEG images that are added to your site in other ways, such as in a template file or the Customizer.

Si Modern Image Formats est activé, l’extension générera-t-elle des versions JPEG et WebP de chaque image que je téléverse ?

By default, the Modern Image Formats plugin will only generate WebP versions of the images that you upload. If you wish to have both WebP and JPEG versions generated, you can navigate to Settings > Media and enable the Generate JPEG files in addition to WebP option.

Avis

15 octobre 2025
Its been years since I had a terrible experience in this eco system UP UNTIL this one. The plugin needs to warn users that once youve regenerated post thumbnails and complete entire process is complete even if you deactivate the plugin wordpress will would force you to use tha Avif or webp version of your images. in which a lot of cases will break site. And one would think you can reverse nope that is not case. I had to result to using a back up data base to restore content. I have about 10K images that includes is variable sizes and variable formats on 2 websites . I Have ZERO plans to figure out which is a jpg and png on those let alone re attach them. There is no official wordpress to manually restore them. This plugin needs to be further improved.
2 septembre 2025
Nice light plugin, does what is says.
25 juin 2025
I love that it doesn’t force you to generate all image sizes of the original format and avif, but just does the avif (or webp if you choose that). It would be really nice if it could rework old images, and maybe even modify the database to match. But still, excellent and should be installed first thing on all new WP sites in my opinion.
27 avril 2025
It worked out-of-the-box with an WooCommerce with about 5000 images. I think it’s the best tool available, especially considering that it’s candidate to be added to the WP core. To be on par with other plugins, essential settings should be added, for example changing the compression level (82% by default) without using any script.
22 avril 2025 1 réponse
Have this running on several websites, with legacy ones regenerating all images successfully. It’s the cleanest approach I’ve seen to maintaining an all AVIF (or WebP) image site. Two issues that I think have easy fixes: It allowed the ‘Force Regenerate Thumbnails’ plugin to convert existing WebP images to AVIF, none of which came out okay and needed manual replacement. Perhaps that was the regenerate plugin being too heavy handed, but it still shouldn’t happen. Adding the ability to exempt certain images or fields from conversion would be ideal. For instance, as several major social media platforms still don’t support AVIF, it would be great to be able to exempt Yoast Social Open Graph images or Feature Images (the default OG image).
Lire les 20 avis

Contributeurs/contributrices & développeurs/développeuses

« Modern Image Formats » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.

Contributeurs

“Modern Image Formats” a été traduit dans 13 locales. Remerciez l’équipe de traduction pour ses contributions.

Traduisez « Modern Image Formats » dans votre langue.

Le développement vous intéresse ?

Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.

Journal des modifications

2.6.0

Bug Fixes

  • Use modern image formats in background images for Cover blocks and Group blocks. (2121)
  • Fixes palette-based PNG uploads failing original full-size AVIF/WebP conversion under GD. (2024)

2.5.1

Bug Fixes

  • Fix Modern Image Format not cropping image if crop is an array. (1887)
  • Fix incorrect image size selection in PICTURE element. (1885)

2.5.0

Améliorations

  • Switch to wp_content_img_tag filter for improved image handling. (1772)

2.4.0

Améliorations

  • Automatically opt into 1536×1536 and 2048×2048 sizes when generating fallback images. (1679)
  • Convert WebP to AVIF on upload. (1724)
  • Enable end user opt-in to generate all sizes in fallback format. (1689)

2.3.0

Améliorations

  • Introduce webp_uploads_get_file_mime_type helper function. (1642)
  • Rename webp_uploads_get_file_mime_type to webp_uploads_get_attachment_file_mime_type to clarify scope. (1662)

Bug Fixes

  • Fix bug that would prevent uploaded images from being converted to the intended output format when having fallback formats enabled. (1635)

2.2.0

Améliorations

  • Convert uploaded PNG files to AVIF or WebP. (1421)

Bug Fixes

  • Account for responsive images being disabled when generating a PICTURE element. (1449)

2.1.0

Améliorations

  • Improve disabling checkbox for Picture Element on Media settings screen. (1470)

Bug Fixes

  • Add missing full size image in PICTURE > SOURCE srcset. (1437)
  • Correct the fallback image in PICTURE element. (1408)
  • Don’t wrap PICTURE element if JPEG fallback is not available. (1450)
  • Fix setting sizes attribute on PICTURE > SOURCE elements. (1354)
  • Remove string type hint from webp_uploads_sanitize_image_format() to prevent possible fatal error. (1410)

Documentation

  • Explain how to regenerate images in the Modern Image Formats readme. (1348)

2.0.2

Améliorations

  • I18N: Add context to Modern Image Formats section title. (1287)

Bug Fixes

  • Improve compatibility of styling picture elements. (1307)

2.0.1

Bug Fixes

  • Fix fatal error when another the_content filter callback returns null instead of a string. (1283)

2.0.0

Features

  • Add picture element support. (73)
  • Add AVIF image format support. Add setting for output image format to choose between WebP and AVIF. (1176)

Améliorations

  • Improve Settings->Media controls for Modern Image Formats. (1273)
  • Remove obsolete fallback script now that picture element is supported. (1269)

1.1.1

Améliorations

  • Prepend Settings link in webp-uploads. (1146)
  • Improve overall code quality with stricter static analysis checks. (775)
  • Bump minimum PHP requirement to 7.2. (1130)

Documentation

  • Updated inline documentation. (1160)

1.1.0

  • Add link to WebP settings to plugins table. (1036)
  • Rename plugin to « Modern Image Formats ». (1101)
  • Use plugin slug for generator tag. (1103)
  • Delete option when uninstalling the Modern Image Formats plugin. (1116)
  • Bump minimum required WP version to 6.4. (1062)
  • Update tested WordPress version to 6.5. (1027)

1.0.5

  • Exclude « .wordpress-org » directory when deploying standalone plugins. (866)

1.0.4

  • Bump minimum required PHP version to 7.0 and minimum required WP version to 6.3. (851)

1.0.3

  • Add standalone plugin assets. (815)

1.0.2

  • Fix WebP handling when editing images based on WordPress 6.3 change. (796)

1.0.1

  • Bump tested up to version to 6.3. (772)

1.0.0

  • Initial release of the Modern Image Formats plugin as a standalone plugin. (664)