Skip to content
Automatically adapts your existing HTML images for mobile devices. No mark-up changes needed.
HTML PHP ApacheConf
Latest commit 2bbd740 Apr 2, 2015 @MattWilcox Update readme.textile


Adaptive Images

Is a solution to automatically create, cache, and deliver device-appropriate versions of your website’s content images. It does not require you to change your mark-up. It is intended for use with Responsive Designs and to be combined with Fluid Image techniques.

Project status

This is an old project now, and still works fine with little need for new features (hence the lack of updates). That said; if you are building a new website I would strongly recommend looking into HTLM’s new ‘picture’ tag, and the srcset and sizes properties now available on regular img tags. These were not available at the time of making AI, and in many cases these are more appropriate solutions today.

That said, there are times when something like AI is still an appropriate solution, and it does still work as advertised.


  • Ensures you and your visitors are not wasting bandwidth delivering images at a higher resolution than the vistor needs.
  • Will work on your existing site, as it requires no changes to your mark-up.
  • Is device agnostic (it works by detecting the size of the visitors screen)
  • Is CMS agnostic (it manages its own image re-sizing, and will work on any CMS or even on flat HTML pages)
  • Is entirely automatic. Once added to your site, you need do no further work.
  • Highly configurable
    • Set the resolutions you want to become adaptive (usually the same as the ones in your CSS @media queries)
    • Choose where you want the cached files to be stored
    • Configure directories to ignore (protect certain directories so AI is not applied to images within them)

Find out more, and view examples at


Adaptive Images by Matt Wilcox is licensed under a Creative Commons Attribution 3.0 Unported License

Something went wrong with that request. Please try again.