Skip to content
This repository

jQuery plugin for lazy loading images

tree: 4efe91d3f5

Fetching latest commit…

Cannot retrieve the latest commit at this time


Lazy Load Plugin for jQuery

Lazy Load delays loading of images in long web pages. Images outside of viewport wont be loaded before user scrolls to them. This is opposite of image preloading.

Using Lazy Load on long web pages containing many large images makes the page load faster. Browser will be in ready state after loading visible images. In some cases it can also help to reduce server load.

Lazy Load is inspired by YUI ImageLoader Utility by Matt Mlinac.

How to Use?

Lazy Load depends on jQuery. Include them both in end of your HTML code:

<script src="jquery.js" type="text/javascript"></script>
<script src="jquery.lazyload.js" type="text/javascript"></script>

You must alter your HTML code. Put the place holder image into src attribute. Demo pages use 1×1 pixel grey gif. URL of the real image must be put into data-original attribute. It is good idea to give Lazy Loaded image a specific class. This way you can easily control which images plugin is binded to.

<img class="lazy" src="img/grey.gif" data-original="img/example.jpg"  width="640" heigh="480">

then in your code do:


This causes all images of class lazy to be lazy loaded.

More information on Lazy Load project page.



  • Fix bug #48. In some cases initial scroll was needed for images to load. (Nick George)
  • Fix bug #42. Reset internal failure counter when image is found. Makes counter logic more intuitive. (Josep del Rio)
  • Fix bug #52. Fix :in-viewport convenience method. (Jonathan Palardy)


  • Allow different elements to use different containers. (Rob Walch)


  • Fix bug #18. Document was always scrolled to top issue on IE 7 and Chrome 17 if using jQuery 1.6 or older. (Ross Allen)
  • General code speedup (Valentin Zwick)


  • Optimized viewport selectors. Around 25% speed increase compared to 1.6.0.
  • Add data_attribute parameter. Allows custom naming of original data attribute. (Bryan Chow)
  • Track window resize event. (Simon Baynes)
  • Add appear event. This function is called when image appears to viewport but before it is loaded.
  • Add load event. This function is called when image is loaded. (Nick Larson)
  • Renamed effectspeed parameter to effect_speed. Old version will still works couple of versions. This parameter was previously undocumented.
  • Fix failure_limit bug #19. (Brandon)


  • Rename original attribute to data-original to be HTML5 friendly.
  • Remove all code regarding placeholder and automatically removing src attribute. It does not work with modern browsers. Must use data-original attribute instead.
  • Add support for James Padolseys scrollstop event. Use when you have hundreds of images.
  • Add skip_invisible parameter. When true plugin will skip invisible images. (Valentin Zwick)
  • Renamed failurelimit parameter to failure_limit. Old version will still work couple of versions.


  • Support for removing the src attribute already in HTML. This is not a drop in solution but gives additional speed for those who need it. (Jeremy Pollock)


  • When scrolling down quickly do not load the images above the top. (Bart Bruil)


  • Support for scrolling within a container.
  • Fixed IE not loading images.
Something went wrong with that request. Please try again.