Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

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

I am not maintaining this project any longer.

This is an old project, and still works as intended, 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, have since become a standard, and in many cases these are more appropriate solutions today.


  • 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


Automatically adapts your existing HTML images for mobile devices. No mark-up changes needed.






No releases published


No packages published