Skip to content


Subversion checkout URL

You can clone with
Download ZIP
FastImage Inline speeds up your webpages with inline images in HTML using a data url
Branch: master


FastImage Inline

FastImage Inline speeds up your webpages with inline images in HTML using a data url

FastImage Inline uses the data uri scheme to place images inline in your image tags, thus saving the http connections that would otherwise have to be made from the browser for each image.

Some major sites already use this optimisation technique – for instance google news. It’s effective when you are using small images (less than 3k bytes), and you do not use those images more than once in a page. Also do not use this for images that you might wish to be cached by the browser – page elements that appear in multiple pages on your site are not good candidates.

This plugin (or gem) adds a helper to rails that adds a method to ask for an image to be served inline inside the html if possible.

Browser support

All modern browsers support this technique except for IE versions 7 and below. This is still a major segment of the market of course, but as IE users migrate to IE 8 this will become less of a problem.

FastImage Inline uses a simple browser detection mechanism by looking at the user agent string. If the browser is known to not have support, or if we do not recognise it at all, we serve a normal image tag which includes the path to the image file in the src attribute. But if we know the browser can handle it, we send the image inline, and the browser won’t need to fetch it separately.



Result for request from a data-uri capable browser:

  <img alt="Bullet" src="data:image/gif;base64,R0lGODlhCAANAJECAAAAAP///////wAAACH5BAEAAAIALAAAAAAIAA0AAAITlI+p
  yxgPI5gAUvruzJpfi0ViAQA7" />

Result for a non-capable browser:

  <img alt="Bullet" src="/images/bullet.gif?1206090639" />


Reportedly IE8 will not handle data strings longer than 32k bytes. But it is probably unwise to inline images this big anyway. Google news serves images that are up to about 3.5k in length, and this seems a reasonable approach. However, FastImage Inline does not enforce any particular constraints, it is for you to decide.

FastImage Inline does not cache the images it has read – so every time an image is sent it will be read from disk. This feature may be added in a later release.


Note that the FastImage gem must be installed first, check the requirements section below.

As a Rails plugin

  ./script/plugin install git://

As a Gem

  sudo gem install fastimage_inline

Install the gem as above, and configure it in your environment.rb file as below:

  ... do |config|
    config.gem "fastimage_inline", :lib=>"fastimage_inline"


  sudo gem install fastimage



The tests are run like this

  $ ruby test/test.rb 
  Loaded suite test/test
  Finished in 0.46836 seconds.

  5 tests, 17 assertions, 0 failures, 0 errors


Something went wrong with that request. Please try again.