Awesome Open Source
Awesome Open Source

Build Status npm GitHub license Donate Donate Bitcoin


jQuery Zoom Gallery plugin.

  • Supports jQuery starting from version 1.2.6.
  • A lof of options, effects and easy to use and customize
  • Lightweight ~14kb minified version.
  • You can load low and high res images separately.
  • Supports IE6+, Chrome, FireFox, Opera, Safari, Android, iOS
  • Supports Responsive output.
  • Have an API to integrate with other useful plugins like FancyBox, Magnific PopUp and HammerJS.


Use one of the following methods:

  • git clone [email protected]:payalord/xZoom.git
  • git clone
  • npm install xzoom
  • bower install xzoom
  • Download zip
  • Use CDN:

Quick Start

Step 1:

  1. Copy xzoom.min.js or xzoom.js file into your javascript folder.
  2. Copy xzoom.css file into your css folder, or copy the content of the xzoom.css file into your site style sheet.
  3. Copy example/images/xloading.gif to your images folder.

Step 2:

This goes into your site's Header Section:

<!-- get jQuery from the google apis or use your own -->
<script src=""></script>

<!-- CSS STYLE-->
<link rel="stylesheet" type="text/css" href="css/xzoom.css" media="all" />

<script type="text/javascript" src="js/xzoom.min.js"></script>

Step 3:

Add xZoom markup into your HTML:

<img class="xzoom" src="path/to/preview_image_01.jpg" xoriginal="path/to/original_image_01.jpg" />

<div class="xzoom-thumbs">
  <a href="path/to/original_image_01.jpg">
    <img class="xzoom-gallery" width="80" src="path/to/thumbs_image_01.jpg"  xpreview="path/to/preview_image_01.jpg">
  <a href="path/to/original_image_02.jpg">
    <img class="xzoom-gallery" width="80" src="path/to/preview_image_02.jpg">
  <a href="path/to/original_image_03.jpg">
    <img class="xzoom-gallery" width="80" src="path/to/preview_image_03.jpg">
  <a href="path/to/original_image_04.jpg">
    <img class="xzoom-gallery" width="80" src="path/to/preview_image_04.jpg">

Step 4:

Initialize the plugin in "document ready" section of your javascript or at the end before </body>:

/* calling script */
$(".xzoom, .xzoom-gallery").xzoom({tint: '#333', Xoffset: 15});

Enjoy xZoom experience!


For full list of options and how to setup, customize and work with xZoom plugin please read the manual.

More Examples

For more examples please check xZoom Sandbox


If you liked the plugin and want to say thanks or want to help us make it better - feel free to make a donation ;)




Donate Bitcoin


Apache License 2.0

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (70,997
jquery (534
image (508
jquery-plugin (230
gallery (143
zoom (75