Site Kit is a one-stop solution for WordPress users to use everything Google has to offer to make…
About WebP Uploads
This plugin allows you to add support for WebP and AVIF image formats in WordPress. It generates modern image formats for new uploads and can convert pre-existing images to these formats if regenerated. You can also choose to generate both the original format and WebP/AVIF formats for all sub-sizes of images.Frequently asked questions
What is the primary function of the WebP Uploads plugin?
The WebP Uploads plugin adds WebP and AVIF support for media uploads within WordPress. It generates modern image formats for new JPEG and PNG uploads if supported by the server.
How does the plugin decide between WebP and AVIF formats?
By default, AVIF images will be generated if supported on the hosting server; otherwise, WebP will be used. If both are available, the output format can be selected under Settings > Media.
Does this plugin convert existing images to modern formats?
No, modern images are generated only for new uploads. Pre-existing images will only be converted if they are regenerated using a plugin like Regenerate Thumbnails or via WP-CLI.
What happens to the original uploaded file format?
By default, only modern image format sub-sizes are generated for JPEG or PNG uploads, meaning the original uploaded file remains as a JPEG/PNG image. Generated image sizes will be WebP or AVIF files.
Can the plugin generate both original and modern formats for sub-sizes?
Yes, by checking the 'Output fallback images' checkbox in Settings > Media, the plugin will generate both the original format and WebP or AVIF images for every sub-size for newly uploaded images.
Changelog
2.5.0
Enhancements
- Switch to
wp_content_img_tagfilter for improved image handling. (1772)
2.4.0
Enhancements
- 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
Enhancements
- Introduce
webp_uploads_get_file_mime_typehelper function. (1642) - Rename
webp_uploads_get_file_mime_typetowebp_uploads_get_attachment_file_mime_typeto 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
Enhancements
- 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
Enhancements
- 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
Enhancements
- 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
pictureelement support. (73) - Add AVIF image format support. Add setting for output image format to choose between WebP and AVIF. (1176)
Enhancements
- Improve Settings->Media controls for Modern Image Formats. (1273)
- Remove obsolete fallback script now that picture element is supported. (1269)
1.1.1
Enhancements
- 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)
