Adaptive Images for WordPress


Adaptive Images

Resizes and optimizes images delivered to mobile devices, in a transparent and unobtrusive way, so that the total download time is dramatically reduced. It works as a filter between the device and your WordPress website. It actually works for all types of device screen sizes, although it is targeted mostly at mobile environments.

Note that this is not a CSS responsive images solution. This plugin does not force browsers to render images as if they were smaller. It actually sends smaller images to them! Then it is the job of the CSS to instruct the browsers how to render them.

Fundamental goals

  1. Reduce the total download time in mobile devices dramatically.
  2. Work transparantly and unobtrusively by being independant of your theme code.
  3. Be agnostic of the yet-not-finalized picture element or HTML img srcset attribute.

Side benefits

  1. Respects search engines and sends them the orginal version of each image, because it depends on Javascript.
  2. If it does not recognise a device screen it falls over to the original image size. But even this is very rare and mostly refers to very old or possibly deprecated devices.
  3. Does not need to load the WordPress ennironment in order to resize and compress images.

Supported formats

  • JPEG
  • PNG
  • GIF (not animated)

CDN/Varnish/external caching service support

Since version 0.6.0 CDN/Varnish/external caching service support has been added as an option, in an experimental mode. This mode is experimental in the following ways: i) it is not thorougly tested yet ii) however, it works in almost all test cases so far iii) it bears no dangers to your installation iv) it adds a special url parameter to your image urls, so it is slightly obtrusive.

Cannot work, not even in experimental mode, with CDNs which use a different subdomain for images, because these setups completely bypass WordPress when delivering images. Feel free to ask for details on this in the support forum.

Default breakpoints

  • 1024px wide screens
  • 640px wide screens
  • 480px wide screens

Since version 0.5.0 and upwards it is configurable whether the plugin should take into account the landscape or the portrait orientation of each device.

HiDPI (high device pixel density or retina) screens are supported too.

How to test

  1. Test with Chrome's device emulation mode in Developer Tools. See here for an example. Unfortunately, Firefox's Responsive Design Mode does not actually emulate a mobile screen size!
  2. Test with a tool like Webpagetest Make sure you set the « Emulate Mobile Browser » setting in the « Advanced Settings » > « Chrome » tab.
  3. Test with a tool like GTmetrix Make sure you enable mobile device testing. The plugin will have no effect on desktop sized devices.
  4. Test with an actual mobile device, a smartphone or tablet. Watch your website load in a snap.
  5. Check the /wp-contents/cache directory to see the /adaptive-images directory and its contents. This is where the resized images are kept and cached by default.

Also you can:

  1. View an image straight from a browser and add a "?debug=true" at the end of the url like this "". This should print useful debug information about the plugin functions in your installation. If you keep seeing your image, then the plugin is not working as it should and the cause is probably a failure to update the .htaccess file properly.
  2. Add a "?debug=original" at the end of the url of an image and you will see the orginal version of the image even when a smaller version of it should have been shown.
  3. Hit the "Print debug" and "Print diagnostics" buttons at the plugin settings page to see useful debug information about the plugin and your WordPress installation.

You could test with a normal desktop browser, but only if the computer screen size falls under at least of one of the specified breakpoints!

Incompatibilities and issues

  • The plugin supports Nginx, but the server’s configuration file must be manually configured like this:

    `location / {
    rewrite .(?:jpe?g|gif|png)$ /wp-content/plugins/adaptive-images/adaptive-images-script.php;
    }« `

  • Windows IIS is not supported, but could be manually configured. Any IIS experts are welcome to contribute.

  • Cannot work, not even in experimental mode, with CDNs which use a different subdomain for images.
  • When using HTTPS/SSL make sure that you update all your website urls and also the urls in your WordPress General
    settings page, otherwise the plugin will not be able to locate your images.

Stuff to keep in mind

  • The plugin needs to add a little bit of code to your .htaccess file in order to function properly. It removes this code once disabled. If you are not cool with that, then… tough luck!
  • The plugin does not care whether the device is actually mobile or not. It checks the device screen resolution. If you have set your breakpoints big enough then it should work just as good for desktop devices as well. However it targets mostly the mobile ones.
  • The resized versions of the pictures are kept in a special directory in the /wp-content/cache directory. This causes some storage overhead. It is up to you to judge whether this overhead is a sustainable option in your hosting environment.
  • The plugin does not help with (nor hinder) art direction. Simple as that. Art direction in responsive images is an entirely different, yet important, problem. This plugin does not tackle with it. But it works in a supplementary way without interfering with other solutions that do. This means that you can combine it with any art direction solution.


  • The plugin was originally based on the WP-Resolutions plugin, but since version 0.3.0 it is a complete rewrite!
  • Both plugins – WP-Resolutions and this one – have borrowed ideas from the Adaptive Images solution specially adapted for WordPress.
  • Many-many thanks to « railgunner » for the initial idea in the forum and to the Pressidium team for helping with debugging the CDN/Varnish/external caching service feature.
  • Thanks to « minorgod » for the Windows path fix.
  • Also, many thanks to my good friend and colleague Antonis Zachopoulos for the countless times that he provided ideas and debugging hints.

Thank you all for using and testing the plugin and, please, do let us know how it works (or doesn’t work) for you. We love comments and creative feedback!

Captures d’écran

  • Plugin settings page in the admin area.
  • Resized versions of your images are cached by default in /wp-content/cache/adaptive-images.
  • Total web page load time is reduced dramatically on a mobile device (tested in
  • Each device is served an image resized its real dimensions, therefore a lot smaller in total size.


Usual process

  1. Install the plugin via « Plugins > Add New ».
  2. Activer l’extension.
  3. Go to its settings and save them!

The plugin should simply work!

De-activate the plugin to disable it. Activate the plugin to enable it. Delete it and it's gone. So simple.


What’s the story?

First came the Adaptive Images solution which is still there and works on its own. Then came the WP-Resolutions plugin But it is not in the WordPress plugin repository anymore and the Github version is not compatible with the latest WordPress versions. So we are updating and maintaining it. Many under the hood changes have taken place, but the overall functionality is the same.

Since version 0.5.0 the plugin has been completely rewritten, in order to not rely on the Adaptive Images solution, which was released under a CC-BY license that is not compatible with the GPL. This problem has now been overcome and the part that used to rely on the Adaptive Images is brand new!

Is this plugin heavy?

Well, not much really. The image resizing process is not computationally negligible, but the images are only resized when they are first requested and then they are cached. However, it must be noted that the images in the watched directories, the ones the plugin is responsible for resizing and delivering, are ultimately delivered by a PHP script and not a generic server process!

So actually one has to decide on a balance between creating and storing too many image sizes in contrast to burdening their server resources.


Awesome Support

I am still in the early stages with this plugin but WOW is the support team and forum really fantastic, especially with how much comes for free. These devs accept donations, and I highly recommend it to support this kind of great team. In particular, I was wondering about the effects on my vector-based PNG images, as I have encountered issues with some similar functionalities built into a theme. They made a test page with my website's images! So cool!

Working Great so far!

One Question: Why isn't this the most used plugin on wordpress? It's 100% necessary for every responsive site that got a few images on it. Great work and I hope it will be maintained and improved because thats a great, good working idea! I use it with WP Rocket on NGinx. I disabled Cloudflare though. How would it be with a classic CDN like Stackpath? Could I use it with adaptive Images?

Excelente… So falta otimizar o PNG ao redimensionar

Excelente... Acelera e muito pois cria e utliza imagens JPG redimensionadas para cada tamanho de dispositivo mobile. Para melhora precisaria otimizar o os arquivos .PNG ao redimensionar para mobiles. === Great... It speeds up a lot because it creates and uses resized JPG images for each size of mobile device. For improvement you would need to optimize the .png files when resizing for mobiles.

Works great, amazing support

Due to a unique setup on our hosting solution we had some trouble getting the plugin to function as intended. The devs at Nevma were extremely helpful and dedicated. They worked with us and our hosting solution techs to get the plugin set up and working correctly. You couldn't ask for better support from a plugin dev!

Works well and great customer service

My adventure with WordPress began after volunteering to create a website for an orphanage in Central America. Not knowing where to start to build a site, I turned to YouTube. The video taught me how to create a site, but it would not work on mobile devices. I tried the Adaptive Images plugin, but it did not work. I ran its diagnostic and sent it to the developer, who promptly replied with instructions of what needed to be done by me and what needed to be done by the web host. After making the appropriate changes, the website still would not work on mobile devices. I contacted the developer again, but did not receive a reply for nearly a week. The eventual reply stated that he was on vacation and would be returning by August 20, 2018. On the exact date of his return, he got on it and examined the settings and found that I was using an unnecessary sub-directory and that by changing the redirect, the problem would be eliminated. Sure enough, the simple fix took care of it. It turns out that all of the problems were due to my inexperience with WP, not the plugin. Living in a small town that borders the jungle in Central America, I was grateful that a developer in Greece was willing to spend time getting to the bottom of the issue and was able to find the appropriate solution. Hat’s off to a job well done! He gave exemplary customer service. I congratulate the developer for a plugin that works, which I strongly recommend for anyone having problems with their website not properly sizing their images for display on mobile devices.
Lire les 48 avis

Contributeurs & développeurs

« Adaptive Images for WordPress » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.




  • Fixed minor bug where watched directories needed to be trimeed.
  • Updated WordPress compatibility to version 5.2.


  • Fixed minor regular expression issue that appeared in PHP 7.3 and caused the cache directory and watched directories to be saved as empty strings.


  • Windows path fix (thanks to @minorgod).


  • Bug fix when HTTPS was reported as « On » vs « on » in PHP. Now the comparison is case insensitive.
  • Bug fix to completely disregard request protocol (HTTP vs HTTPS) when resolving image paths from request urls.


  • Bug fix handling decimal device pixel density.
  • Bug fix when the wp-content and/or uploads directories have been renamed.
  • Bug fix when WordPress installation is in a subdirectory, but the website url remains in the root directory.
  • Settings page user interface corrections.


  • Added notice for NginX’s manual configuration.
  • Minor bug fixes.


  • Removed PNG8 compression for PNGs because it was not peoducing acceptable quality results. PNGs are now simply resized and compressed via normal 32bit PNG compression. In future versions there will be an option to enable and disable PNG8 compression at will and perhaps a way for the plugin to detect in which images it should apply PNG8 compression and in which others to apply 32bit PNG compression.


  • Just an update to the plugin version, because 0.6.41 was coming before 0.6.5, due to a lexicographical sorting and was not available as an update in the repository!


  • PHP warning in adaptive images script removed.


  • Minor bug fix when saving plugin settings.


  • Version 0.6.4 bug fix caused a new bug in image path resolution when the WordPress is installed in a subdirectory of the server root directory.


  • Fixed bug wp-content dir resolution within the standalone Adaptive Images image handling scrips, where sometimes the server document root was not reported by PHP as being the same as the WordPress installation path.


  • Fixed bug in htaccess rewrite rules generation when installation is not in root directory.
  • Fixed bug in image delivery script where browser cache was not set correctly in some case.


  • Fixed bug where WordPress installation root directory was not calculated correctly in certain cases.


CDN/Varnish compatibility improved. Previously some images were downloaded in both their original and their resized version. Now they are only downloaded once. However if the website is too fast there may be 1-2 images that might manage to download in their original size. We guess that is OK, though.


  • Added CDN/Varnish/external caching service support.
  • Added Thickbox confirmation dialog on the cache cleanup button in the plugin settings page.
  • Added donation button in the plugin settings page.
  • Documentation stuff.


  • Fixed a bug where the path of the image resizing script was not correctly created in the .htaccess file (again).


  • Fixed a bug where the path of the image resizing script was not correctly created in the .htaccess file.
  • Some documentation.


  • New option in settings to define whether the plugin should use the bigger dimension of a device as its with or take into account the current orientation. Up to now the plugin used the width of the landscape orientation, which is the biggest of each device's dimensions.
  • New option in settings to define whether the plugin should use take special care for HiDPI (retina, high pixel density screens and serve these devices better quality images according to their pixel density.
  • Better PNG compression via PNG8. This converts true color PNG images to palette image, which reduces colours and the alpha channel Kudos
  • Fixed some edge cases of not being able to serve a resized image by reverting to original image.
  • More analytical settings page debugging and diagnostics.
  • Added debugging methods in the image cache generation script.
  • Plugin can be configured to respect your default expires headers.
  • Some documentation stuff (as always).
  • Completely rewritten the script that generates and caches the resized versions of images in order to avoid the GPL vs CC-BY-3.0 licensing incompatibility of the original Adaptive Images script ( Plugin is now totally independant and free of any licensing issues.
  • Due to the above, the image resizing script is no longer the same, it has been transformed to a new script, named adaptive-images-script.php which is in the root folder of the plugin. However the old script is still left inside the plugin folders for compatibility purposes (old versions and users not having saved their settings anew).


  • Documentation stuff.


  • Minor bug in settings page url parameters.
  • Documentation stuff.


  • Allow for default browser cache settings.
  • More thorough debugging information.
  • Added diagnostics debugging in the settings page.
  • Nicer admin area user messages with icons.
  • Minor fixes here (and there).
  • Documentation enhancements.


  • Documentation enhancements (yeah).
  • Added "noptimize" tag in HEAD Javascript to exclude it from optimizers.


  • Added Last-modified HTTP header for resized images, as the best practices do suggest.


  • When no device size/resolution is detected then show the original image. Helps avoid misunderstandings and sends search engines the actual images instead of the resized ones.


  • Documentation enhancements.


  • Almost a complete rewrite of the code.
  • Completely updated the settings page to be user friendly.
  • Added action in the settings page for cache cleanup.
  • Added action in the settings page for debug info.
  • Added action in the settings page for cache size calculation.
  • Added watched directories field in the settings page anew.
  • Divided the plugin files into logical parts.
  • Default resolutions changed to 1024, 640 and 480 because the cookie is set based on the max value between screen width and height and most screens have a height between 480 and 640px. Tablets are between 640 and 1024px wide/tall. The iPad is 1024px tall. A screen with a width higher than 1024px is probably not a mobile screen.
  • Changed default image cache directory in order to place it inside the expected WordPress /wp-content/cache directory, so now by default it is /wp-content/cache/adaptive-images.
  • Added check for the plugin options.
  • Added check for the PHP GD library.
  • Added check for the .htaccess file.
  • Added upgrade from older versions functions.
  • Added upgrade from 0.2.08 to 0.3.0 versions functions.
  • Added unistall script uninstall.php.
  • Documentation enhancements (as usual).


  • Added cache size calculation.
  • Added cache clean up methods.
  • Added nonces to admin actions.
  • Documentation enhancements.


  • Settings are now separate in an ai-user-settings.php file.


  • If the original requested image width and the device screen size are bigger than maximum available breakpoint, then serve the the original image.


  • Refactoring code.


  • Set the default screen size breakpoints to 1024, 600, 320.


  • Refactoring code to separate Adaptive Images files from the other plugin files.


  • The first stable version after the initial fork.
  • Corrected basic PHP errors.
  • Corrected basic WordPress errors.
  • Now compatible with version 4.1.1.
  • New document root takes into account installations in subdirectories.


  • The version forked from the WP Resolutions plugin
  • This version does not work with WordPress anymore (at least version 4.1.1 and upwards).