Title: Modern Image Formats
Author: WordPress Performance Team
Published: <strong>ഏപ്രിൽ 6, 2023</strong>
Last modified: ജനുവരി 9, 2026

---

Search plugins

![](https://ps.w.org/webp-uploads/assets/banner-772x250.png?rev=3098226)

![](https://ps.w.org/webp-uploads/assets/icon.svg?rev=3098226)

# Modern Image Formats

 By [WordPress Performance Team](https://profiles.wordpress.org/performanceteam/)

[Download](https://downloads.wordpress.org/plugin/webp-uploads.2.6.1.zip)

 * [Details](https://ml.wordpress.org/plugins/webp-uploads/#description)
 * [Reviews](https://ml.wordpress.org/plugins/webp-uploads/#reviews)
 *  [Installation](https://ml.wordpress.org/plugins/webp-uploads/#installation)
 * [Development](https://ml.wordpress.org/plugins/webp-uploads/#developers)

 [Support](https://wordpress.org/support/plugin/webp-uploads/)

## 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](https://wordpress.org/plugins/regenerate-thumbnails/)
or via WP-CLI with the `wp media regenerate` [command](https://developer.wordpress.org/cli/commands/media/regenerate/).

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 from within WordPress

 1. Visit **Plugins > Add New**.
 2. Search for **Modern Image Formats**.
 3. Install and activate the **Modern Image Formats** plugin.

#### Manual installation

 1. Upload the entire `webp-uploads` folder to the `/wp-content/plugins/` directory.
 2. Visit **Plugins**.
 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

### 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](https://github.com/WordPress/performance/issues/new/choose).
If you need help with troubleshooting or have a question about the plugin, please
[create a new topic on our support forum](https://wordpress.org/support/plugin/webp-uploads/#new-topic-0).

### Where can I report security bugs?

The Performance team and WordPress community take security bugs seriously. We appreciate
your efforts to responsibly disclose your findings, and will make every effort to
acknowledge your contributions.

To report a security issue, please visit the [WordPress HackerOne](https://hackerone.com/wordpress)
program.

### How can I contribute to the plugin?

Contributions are always welcome! Learn more about how to get involved in the [Core Performance Team Handbook](https://make.wordpress.org/performance/handbook/get-involved/).

### I’ve activated the Modern Image Formats plugin, but WebP images are not always generated when I upload a JPEG image. Why?

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](https://wordpress.com/support/media/).
    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](https://wordpress.com/support/customizer/).

### With the Modern Image Formats plugin activated, will the plugin generate JPEG and WebP versions of every image that I upload?

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.

## Reviews

![](https://secure.gravatar.com/avatar/80e914c33cfcb58bb025742ce294e1d12f214079d7e14ac31b35e24477c06eda?
s=60&d=retro&r=g)

### 󠀁[Funktioniert wie beschrieben – Heimvorteil weil von WordPress entwickelt](https://wordpress.org/support/topic/funktioniert-wie-beschrieben-heimvorteil-weil-von-wordpress-entwickelt/)󠁿

 [lacoste89](https://profiles.wordpress.org/lacoste89/) മാർച്ച്‌ 22, 2026

Ich nutze dieses Plugin auf allen neuen Webseiten, damit Bilder automatisch nach
AVIF konvertiert werden. Es funktionierte bisher immer ohne Probleme, deshalb kann
ich es uneingeschränkt empfehlen. Ich hoffe es wird bald auch direkt in den WordPress
Core übernommen.

![](https://secure.gravatar.com/avatar/92b7d005d1ba6b94b4e69814a40933f600fdcdcb097f2e1b5e4ae23d53535ee0?
s=60&d=retro&r=g)

### 󠀁[Doesn’t work, support not helpful](https://wordpress.org/support/topic/doesnt-work-support-not-helpful/)󠁿

 [primerpizza](https://profiles.wordpress.org/primerpizza/) ഡിസംബർ 15, 2025 2 replies

Been trying to get this thing to work but it just wont serve the generated images.
Support stopped replying.

![](https://secure.gravatar.com/avatar/59b7515a7f9777abdad9c4840dac6840c596b9cf94a60bfef5222a5afaef8e6e?
s=60&d=retro&r=g)

### 󠀁[compression?](https://wordpress.org/support/topic/compression-6/)󠁿

 [pdjp](https://profiles.wordpress.org/pdjp/) ഡിസംബർ 9, 2025 5 replies

Good plugin, but no option to set the WebP compression value. What compression is
used here?

![](https://secure.gravatar.com/avatar/8ac685e8921cd7f33441b7099600fbe6cc87013ca810162ae2415a8a686bf8bb?
s=60&d=retro&r=g)

### 󠀁[causes an Irreversible damage to your Media library NEEDS and Explicit warning](https://wordpress.org/support/topic/causes-an-irreversible-damage-to-your-media-library-needs-and-explicit-warning/)󠁿

 [faospark](https://profiles.wordpress.org/faospark/) ഒക്ടോബർ 15, 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.

![](https://secure.gravatar.com/avatar/222ae0c7209b2c1624b3560bd96c1d68900cdfcfd41495610c5da40ab7447079?
s=60&d=retro&r=g)

### 󠀁[Good one](https://wordpress.org/support/topic/good-one-623/)󠁿

 [nmask](https://profiles.wordpress.org/nmask/) സെപ്റ്റംബർ 2, 2025

Nice light plugin, does what is says.

![](https://secure.gravatar.com/avatar/488fa9427cd9420d96a8a423f6186e0ab7c14865020ae2432ec789472b70f38f?
s=60&d=retro&r=g)

### 󠀁[So far so good!](https://wordpress.org/support/topic/so-far-so-good-1276/)󠁿

 [Masoud Golchin](https://profiles.wordpress.org/masoudin/) ഓഗസ്റ്റ്‌ 8, 2025

Thanks for developing this plugin!It’s my #1 plugin for image optimization!

 [ Read all 22 reviews ](https://wordpress.org/support/plugin/webp-uploads/reviews/)

## Contributors & Developers

“Modern Image Formats” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ WordPress Performance Team ](https://profiles.wordpress.org/performanceteam/)
 *   [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/)

“Modern Image Formats” has been translated into 15 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/webp-uploads/contributors)
for their contributions.

[Translate “Modern Image Formats” into your language.](https://translate.wordpress.org/projects/wp-plugins/webp-uploads)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/webp-uploads/), check
out the [SVN repository](https://plugins.svn.wordpress.org/webp-uploads/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/webp-uploads/) by
[RSS](https://plugins.trac.wordpress.org/log/webp-uploads/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.6.1

**Bug Fixes**

 * Add a simple PHP version check around a deprecated function. ([2285](https://github.com/WordPress/performance/pull/2285))
 * Fix missing `PICTURE` element support for post thumbnail and add missing Modern
   Image Formats support for Widget block. ([2179](https://github.com/WordPress/performance/pull/2179))

#### 2.6.0

**Bug Fixes**

 * Use modern image formats in background images for Cover blocks and Group blocks.(
   [2121](https://github.com/WordPress/performance/pull/2121))
 * Fixes palette-based PNG uploads failing original full-size AVIF/WebP conversion
   under GD. ([2024](https://github.com/WordPress/performance/pull/2024))

#### 2.5.1

**Bug Fixes**

 * Fix Modern Image Format not cropping image if crop is an array. ([1887](https://github.com/WordPress/performance/pull/1887))
 * Fix incorrect image size selection in `PICTURE` element. ([1885](https://github.com/WordPress/performance/pull/1885))

#### 2.5.0

**Enhancements**

 * Switch to `wp_content_img_tag` filter for improved image handling. ([1772](https://github.com/WordPress/performance/pull/1772))

#### 2.4.0

**Enhancements**

 * Automatically opt into 1536×1536 and 2048×2048 sizes when generating fallback
   images. ([1679](https://github.com/WordPress/performance/pull/1679))
 * Convert WebP to AVIF on upload. ([1724](https://github.com/WordPress/performance/pull/1724))
 * Enable end user opt-in to generate all sizes in fallback format. ([1689](https://github.com/WordPress/performance/pull/1689))

#### 2.3.0

**Enhancements**

 * Introduce `webp_uploads_get_file_mime_type` helper function. ([1642](https://github.com/WordPress/performance/pull/1642))
 * Rename `webp_uploads_get_file_mime_type` to `webp_uploads_get_attachment_file_mime_type`
   to clarify scope. ([1662](https://github.com/WordPress/performance/pull/1662))

**Bug Fixes**

 * Fix bug that would prevent uploaded images from being converted to the intended
   output format when having fallback formats enabled. ([1635](https://github.com/WordPress/performance/pull/1635))

#### 2.2.0

**Enhancements**

 * Convert uploaded PNG files to AVIF or WebP. ([1421](https://github.com/WordPress/performance/pull/1421))

**Bug Fixes**

 * Account for responsive images being disabled when generating a PICTURE element.(
   [1449](https://github.com/WordPress/performance/pull/1449))

#### 2.1.0

**Enhancements**

 * Improve disabling checkbox for Picture Element on Media settings screen. ([1470](https://github.com/WordPress/performance/pull/1470))

**Bug Fixes**

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

**Documentation**

 * Explain how to regenerate images in the Modern Image Formats readme. ([1348](https://github.com/WordPress/performance/pull/1348))

#### 2.0.2

**Enhancements**

 * I18N: Add context to Modern Image Formats section title. ([1287](https://github.com/WordPress/performance/pull/1287))

**Bug Fixes**

 * Improve compatibility of styling picture elements. ([1307](https://github.com/WordPress/performance/pull/1307))

#### 2.0.1

**Bug Fixes**

 * Fix fatal error when another the_content filter callback returns null instead
   of a string. ([1283](https://github.com/WordPress/performance/pull/1283))

#### 2.0.0

**Features**

 * Add `picture` element support. ([73](https://github.com/WordPress/performance/pull/73))
 * Add AVIF image format support. Add setting for output image format to choose 
   between WebP and AVIF. ([1176](https://github.com/WordPress/performance/pull/1176))

**Enhancements**

 * Improve Settings->Media controls for Modern Image Formats. ([1273](https://github.com/WordPress/performance/pull/1273))
 * Remove obsolete fallback script now that picture element is supported. ([1269](https://github.com/WordPress/performance/pull/1269))

#### 1.1.1

**Enhancements**

 * Prepend Settings link in webp-uploads. ([1146](https://github.com/WordPress/performance/pull/1146))
 * Improve overall code quality with stricter static analysis checks. ([775](https://github.com/WordPress/performance/issues/775))
 * Bump minimum PHP requirement to 7.2. ([1130](https://github.com/WordPress/performance/pull/1130))

**Documentation**

 * Updated inline documentation. ([1160](https://github.com/WordPress/performance/pull/1160))

#### 1.1.0

 * Add link to WebP settings to plugins table. ([1036](https://github.com/WordPress/performance/pull/1036))
 * Rename plugin to “Modern Image Formats”. ([1101](https://github.com/WordPress/performance/pull/1101))
 * Use plugin slug for generator tag. ([1103](https://github.com/WordPress/performance/pull/1103))
 * Delete option when uninstalling the Modern Image Formats plugin. ([1116](https://github.com/WordPress/performance/pull/1116))
 * Bump minimum required WP version to 6.4. ([1062](https://github.com/WordPress/performance/pull/1062))
 * Update tested WordPress version to 6.5. ([1027](https://github.com/WordPress/performance/pull/1027))

#### 1.0.5

 * Exclude “.wordpress-org” directory when deploying standalone plugins. ([866](https://github.com/WordPress/performance/pull/866))

#### 1.0.4

 * Bump minimum required PHP version to 7.0 and minimum required WP version to 6.3.(
   [851](https://github.com/WordPress/performance/pull/851))

#### 1.0.3

 * Add standalone plugin assets. ([815](https://github.com/WordPress/performance/pull/815))

#### 1.0.2

 * Fix WebP handling when editing images based on WordPress 6.3 change. ([796](https://github.com/WordPress/performance/pull/796))

#### 1.0.1

 * Bump tested up to version to 6.3. ([772](https://github.com/WordPress/performance/pull/772))

#### 1.0.0

 * Initial release of the Modern Image Formats plugin as a standalone plugin. ([664](https://github.com/WordPress/performance/pull/664))

## Community plugin

This plugin is developed and supported by a community. [Contribute to this plugin](https://github.com/WordPress/performance)

## Meta

 *  Version **2.6.1**
 *  Last updated **3 മാസങ്ങള്‍ ago**
 *  Active installations **100,000+**
 *  WordPress version ** 6.6 അല്ലെങ്കില്‍ അതിലും ഉയര്‍ന്നത് **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.2 അല്ലെങ്കില്‍ അതിലും ഉയര്‍ന്നത് **
 *  Languages
 * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/webp-uploads/), [Dutch](https://nl.wordpress.org/plugins/webp-uploads/),
   [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/webp-uploads/), [English (US)](https://wordpress.org/plugins/webp-uploads/),
   [German](https://de.wordpress.org/plugins/webp-uploads/), [Japanese](https://ja.wordpress.org/plugins/webp-uploads/),
   [Korean](https://ko.wordpress.org/plugins/webp-uploads/), [Norwegian (Bokmål)](https://nb.wordpress.org/plugins/webp-uploads/),
   [Persian](https://fa.wordpress.org/plugins/webp-uploads/), [Portuguese (Brazil)](https://br.wordpress.org/plugins/webp-uploads/),
   [Portuguese (Portugal)](https://pt.wordpress.org/plugins/webp-uploads/), [Spanish (Chile)](https://cl.wordpress.org/plugins/webp-uploads/),
   [Spanish (Spain)](https://es.wordpress.org/plugins/webp-uploads/), [Swedish](https://sv.wordpress.org/plugins/webp-uploads/),
   [Turkish](https://tr.wordpress.org/plugins/webp-uploads/), ഉം [Vietnamese](https://vi.wordpress.org/plugins/webp-uploads/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/webp-uploads)
 * Tags
 * [AVIF](https://ml.wordpress.org/plugins/tags/avif/)[images](https://ml.wordpress.org/plugins/tags/images/)
   [performance](https://ml.wordpress.org/plugins/tags/performance/)[webp](https://ml.wordpress.org/plugins/tags/webp/)
 *  [Advanced View](https://ml.wordpress.org/plugins/webp-uploads/advanced/)

## Ratings

 5ൽ 3.3 നക്ഷത്രങ്ങൾ.

 *  [  12 5-star reviews     ](https://wordpress.org/support/plugin/webp-uploads/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/webp-uploads/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/webp-uploads/reviews/?filter=3)
 *  [  1 2-star review     ](https://wordpress.org/support/plugin/webp-uploads/reviews/?filter=2)
 *  [  9 1-star reviews     ](https://wordpress.org/support/plugin/webp-uploads/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/webp-uploads/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/webp-uploads/reviews/)

## Contributors

 *   [ WordPress Performance Team ](https://profiles.wordpress.org/performanceteam/)
 *   [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/)

## Support

Issues resolved in last two months:

     2 out of 4

 [View support forum](https://wordpress.org/support/plugin/webp-uploads/)