Images to WebP


Statistics say that WebP format can save over a half of the page weight without losing images quality.
Convert PNG, JPG and GIF images to WebP and speed up your web, save visitors download data, make your Google ranking better.

  • automated test after plugin activation to make sure it will work on your server
  • works with all types of WordPress installations: domain, subdomain, subdirectory, multisite/network
  • 可在Apache 或 NGiNX上工作
  • image URL will be not changed so it works everywhere, in <img> src, srcset, <picture>, even in CSS backgrounds and there is no problem with cache
  • original files will be not touched
  • set quality of converted images
  • auto convert on upload
  • only convert image if WebP filesize is lower than original image filesize
  • bulk convert existing images to WebP ( you can choose folders )
  • bulk convert only missing images
  • 与“ Fly Dynamic Image Resizer”插件配合使用

Hooks for developers


Maybe you want to support also less famous JPEG extension like jpe, jfif or jif

add_filter( 'itw_extensions', 'extra_itw_extensions', 10, 1 );
function extra_itw_extensions( $extensions ){
    $extensions[] = 'jpe';
    $extensions[] = 'jfif';
    $extensions[] = 'jif';
    return $extensions;


Maybe you want to disable WebP for thumbnails

add_filter( 'itw_sizes', 'disable_itw_sizes', 10, 2 );
function disable_itw_sizes( $sizes, $attachmentId ){
    unset( $sizes['thumbnail'] );
    return $sizes;


Maybe you want to modify htaccess rules somehow

add_filter( 'itw_htaccess', 'modify_itw_htaccess', 10, 2 );
function modify_itw_htaccess( $rewrite_rules ){
    // do some magic here
    return $rewrite_rules;


Maybe you use or other custom folder structure

add_filter( 'itw_abspath', 'modify_itw_abspath', 10, 2 );
function modify_itw_abspath( $abspath ){
    return trailingslashit( WP_CONTENT_DIR );


或许你想使用其他插件自动生成 WebP

add_action( 'XXPLUGIN_image_created', 'XX_images_to_webp', 10, 2 );
function XX_images_to_webp( $image_path ){
    global $images_to_webp;
    $images_to_webp->convert_image( $image_path );



  1. Upload images-to-webp directory to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress


Plugin requirements

It should work almost everywhere 😉
PHP 5.6 or higher
GD or Imagick extension with WebP support
Enabled server modules: mod_mime, mod_rewrite

WebP images stored location

WebP images are generated in same directory as original image. Example:
original img: /wp-content/uploads/2019/11/car.png
webp version: /wp-content/uploads/2019/11/car.png.webp

How to get original image from the browser?

Just add ?no_webp=1 to the URL and original JPG/PNG will be loaded

How to check if plugin works?

When you have installed plugin and converted all images, follow these steps:

  1. Run Google Chrome and enable Dev Tools (F12).
  2. Go to the Network tab click on Disable cache and select filtering for Img (Images).
  3. Refresh your website page.
  4. Check list of loaded images. Note Type column.
  5. If value of webp is there, then everything works fine.

NGiNX and Apache together

If you have some proxy setup or some other combination of NGiNX and Apache on your server, then probably .htaccess changes won’t work and you will need to ask your hosting provider to disable NGiNX direct processing of image static files.

Apache .htaccess


<IfModule mod_mime.c>
    AddType image/webp .webp

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{HTTP_ACCEPT} image/webp
    RewriteCond %{REQUEST_FILENAME} "/"
    RewriteCond %{REQUEST_FILENAME} "\.(jpg|jpeg|png|gif)$"
    RewriteCond %{REQUEST_FILENAME}\.webp -f
    RewriteCond %{QUERY_STRING} !no_webp
    RewriteRule ^(.+)$ $1\.webp [NC,T=image/webp,E=webp,L]

NGiNX 配置


You need to add this map directive to your http config, usually nginx.conf ( inside of the http{} section ):

map $arg_no_webp $no_webp{
    default "";
    "1" "no_webp";

map $http_accept $webp_suffix{
    default "";
    "~*webp" ".webp";

then you need to add this to your server block, usually site.conf or /nginx/sites-enabled/default ( inside of the server{} section ):

location ~* ^/.+\.(png|gif|jpe?g)$ {
    add_header Vary Accept;
    try_files $uri$webp_suffix$no_webp $uri =404;

ISP Manager

Are you using ISP Manager? Then it’s probably not working for you, but no worries, you just need to go to WWW domains and delete jpg|jpeg|png from the Static content extensions field.

Delete all generated WebP images

There is no button to do that and it will also not delete generated WebPs automatically when you deactivate the plugin, but if you really need this, you can run some shell command to achieve this:

find . -type f -name "*.webp" -exec bash -c 'if [ -f "${1%.webp}" ]; then echo "Deleting $1"; rm "$1"; fi' _ {} \;

This will find all the files with a .webp extension and if there is similar file with the exact filename, but without the .webp extension, then it will delete it.


2024 年 1 月 6 日 2 回复
Just came across your profile because i use your smooth scroll plugin on many customers of mine. So i saw that you have some other plugins and now im using beside the smooth scroll plugin also the CPT Plugin and this WebP Plugin.All Plugins are super simple and very easy to use. They also all work as thei should. Perfect! Thanks for your work!Im corious if you could also add avif as supported format 🙂
2023 年 9 月 29 日
You are getting feedback about SEO issues likely because when the “delete” option is selected the plugin needs to remove the http_accept line from the .htaccess rules (also the nowebp line makes no sense if the delete option is used).Since the desktop crawler agents won’t pass the http_accept rule the search crawlers will get 404 errors trying to load deleted originals.After a few years of WebP conversion experience I’ve found the reason some images come out larger is because they were compressed far too lossy (almost always a small JPG), but there is a command line option for CWebP that will match the original file size so you can do a full conversion to WebP.
2023 年 6 月 19 日
I like the more minimalistic approach of this plugin. Most similar plugins tend to be very bloated and constantly annoy you with advertising the pro version. I also like the clear and simple UI.
2023 年 5 月 1 日 1 回复
Apache installation was flawless. Worked straight away exactly as per instructions. NGINX still gave me 502 error and despite doing all mentioned in FAQ, I was unable to get it to work on NGINX.However, I was able to switch to Apache so for this client, all was well.I’ll have to try and see where I messed up the NGINX installation, because I’m sure that there will be times when I don’t have the luxury of switching servers.


“Images to WebP” 是开源软件。 以下人员对此插件做出了贡献。


「Images to WebP」插件已被翻译至 5 种本地化语言。 感谢所有译者为本插件所做的贡献。

将“Images to WebP”翻译成您的语言。





  • Tested on WP 6.5


  • Fix for “Find and convert MISSING images” button


  • Tested on WP 6.4
  • added FAQ section “Delete all generated WebP images”


  • Tested on WP 6.3
  • added FAQ section “NGiNX and Apache together”
  • make configs error messages more descriptive


  • Tested on WP 6.2
  • new filter itw_abspath for WP installations with customized folder structure like Bedrock


  • make convert old works also for local installations


  • fix – convert also all subdirectories


  • lazy load folders in convert tab
  • make it works for local installations like XAMPP or Flywheel Local
  • try-catch conversion errors
  • updated jstree library


  • add ?no_webp=1 to URL to receive original image content from Nginx server


  • Tested on WP 6.1
  • added support for Better image sizes plugin
  • add ?no_webp=1 to URL to receive original image content – works only on Apache and only with direct image URL


  • Tested on WP 6.0
  • convert and serve WebP images anywhere – not only in wp-content folder
  • option to delete original images after conversion


  • Tested on WP 5.9


  • Tested on WP 5.8
  • added some nonce checks and more security validations
  • better nginx instructions


  • Tested on WP 5.7
  • add more CURL options
  • fix backslashes for localhosts


  • Tested on WP 5.6
  • fixed problem on some multisites


  • Tested on WP 5.4
  • added support for Fly Dynamic Image Resizer plugin


  • notice when test image is not accessible


  • new test method


  • fixed text domain for translations


  • added instructions for NGiNX


  • make it works in multisite and subdirectory installs


  • First version