lazyload image plugin for Hexo.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib Using throttle and update readme May 13, 2018
.eslintrc 1. Add only post lazy load support. 2. Refactor 3. add eslint. Jul 30, 2017
.gitignore the first concrate commit Jul 30, 2017
LICENSE Initial commit Jul 30, 2017 Using throttle and update readme May 13, 2018
package.json 1.0.3 Aug 1, 2017


hexo-lazyload-image is a hexo plugin which is used to have all images support lazyload automatically. With the help of this functionality, it will improve lots of the loading proformance..

All the lazy-load images only shows up when they are within current viewport.

Don't worry about lazyload SEO problem, because Google supports it already. we just Do nothing.


$ npm install hexo-lazyload-image --save


First add configuration in _config.yml from your hexo project.

  enable: true 
  onlypost: false
  loadingImg: # eg /images/loading.gif


  • If true, only the images from post or page will support lazy-load.
  • If false, the whole images of your site will use lazy-load, including the images dist from your theme, but not including the background images from CSS style.


  • If you keep the value nothing (by default), then it will use the default loading image.
  • If you want to customize the image, then you need to copy your loading image to your current theme image folder and then change this path to find it.

Run hexo command.

$ hexo clean && hexo g


I've test it manually with some popular themes like landscape(official), material, next, jacman and myself theme hexo-theme-twentyfifteen-wordpress, and yours I believe!

Enjoy it!