Title: WP ImageViewer
Author: Marcel Pol
Published: <strong>ନଭେମ୍ବର 30, 2018</strong>
Last modified: ଫେବୃୟାରୀ 4, 2026

---

Search plugins

![](https://ps.w.org/wp-imageviewer/assets/banner-772x250.png?rev=2047278)

![](https://ps.w.org/wp-imageviewer/assets/icon-256x256.png?rev=2047278)

# WP ImageViewer

 By [Marcel Pol](https://profiles.wordpress.org/mpol/)

[Download](https://downloads.wordpress.org/plugin/wp-imageviewer.3.0.1.zip)

 * [Details](https://ory.wordpress.org/plugins/wp-imageviewer/#description)
 * [Reviews](https://ory.wordpress.org/plugins/wp-imageviewer/#reviews)
 *  [Installation](https://ory.wordpress.org/plugins/wp-imageviewer/#installation)
 * [Development](https://ory.wordpress.org/plugins/wp-imageviewer/#developers)

 [Support](https://wordpress.org/support/plugin/wp-imageviewer/)

## Description

ImageViewer is an image viewer inspired by Google Photo’s.
 It may also look familiar
to users of Ebay.com or Tweakers.net.

It provides a modal for images, similar to modals as lightbox, colorbox and fancybox,
just in a somewhat more abstract way.

#### Features

 * Smooth dragging and panning images.
 * Support touch devices.
 * Double tap to zoom in/zoom out.
 * Pinch in / pinch out to zoom in/out.
 * Snap view for easier panning and zooming experience.
 * Exposed API to control zoom programmatically.

#### Anti-Features

 * Clean user interface, no bells, no whistles, no horns.
 * Lightweight code (no PHP, 2 JS files and 1 CSS file).
 * No settings page (really).
 * No database queries.

#### Upstream Project

You can look at [Github](https://github.com/s-yadav/iv-viewer) for the original 
code.
 This project is integrated in this WordPress plugin and all ready to use.

#### Compatibility

This plugin is compatible with [ClassicPress](https://www.classicpress.net).

#### Contributions

This plugin is also available in [Codeberg](https://codeberg.org/cyclotouriste/wp-imageviewer).

## Installation

#### Installation

 * Install the plugin through the admin page “Plugins”.
 * Alternatively, unpack and upload the contents of the zipfile to your ‘/wp-content/
   plugins/’ directory.
 * Activate the plugin through the ‘Plugins’ menu in WordPress.
 * That’s it.

It should just work on the standard WordPress gallery and images.

## FAQ

### I have an image, but when I click nothing happens

This plugin expects the same html layout as lightbox, colorbox and fancybox. The
image/thumbnail should be inside a link, an a element.
 That link should point to
the main media image, not the attachment page or a custom link. Only when the link
points to an image file, it will show the viewer,

### I am using Nextgen Gallery

You can go to Gallery > Other Options > Lightbox Effect-tab and select None for 
the Lightbox Effect.

### I would like to use custom options for the viewer

This code should help you, you can change these default values and put this PHP 
code in the functions.php file of your theme (preferably a child theme).

    ```
    <?php
    function imageviewer_custom_options() {
        ?>
        <script>
        imageviewer_custom_options = {
            zoomValue: 100,
            snapView: true,
            maxZoom: 500,
            refreshOnResize: true,
            zoomOnMouseWheel: true
        };
        </script>
        <?php
    }
    add_action( 'wp_footer', 'imageviewer_custom_options' );
    ?>
    ```

## Reviews

![](https://secure.gravatar.com/avatar/2c9d3c84b7aa6e3b21fb6626cec82586d72c5641338c815998580c808d5c770e?
s=60&d=retro&r=g)

### 󠀁[Not perfect, but nice](https://wordpress.org/support/topic/not-perfect-but-nice-3/)󠁿

 [alvincha](https://profiles.wordpress.org/alvincha/) ଅଗଷ୍ଟ 25, 2025

Basically I wanted something that resemble the “Photos Viewer Application” from 
Windows where you can zoom and pan on large images. This is the closest I found 
for now.WP ImageViewer works nicely but there is a few things that prevent it from
being perfect imo:1- When you zoom in an image, it doesn’t zoom where your cursor
is but zoom at the bottom of the image automatically which is pretty annoying especially
for large images2- Since it’s integrated to WP directly there isn’t any easy customization
available, you cant change the position of arrows for e.g. that are not vertically
centered as in every Lightbox I can think of3- Lightbox does not close when the 
user is clicking outside the image, I do like this in Lightboxes personnally4- I
don’t think it’s possible to separate the images within a page from the same Slider/
Lightbox. What I mean is, if you have let’s say 3 gallery of 5 images and use this
plugin on all of them, you can’t have 3 separate Slider with 5 images, you end up
having a giant Slider where you can loop back to image number 1 from the very last
image of the page. It would be nice to be able to separate them5- Be able to change
buttons icons would be nice even tho I guess it’s possible by doing some extra work

![](https://secure.gravatar.com/avatar/7f6d9760be174f06f7539e7cd555e6c6ebe9a08c12e36d6feb9ddf459c26f38c?
s=60&d=retro&r=g)

### 󠀁[简陋而优雅。Rough yet Elegent](https://wordpress.org/support/topic/%e7%ae%80%e9%99%8b%e8%80%8c%e4%bc%98%e9%9b%85%e3%80%82rough-yet-elegent/)󠁿

 [benyangovo](https://profiles.wordpress.org/benyangovo/) ନଭେମ୍ବର 10, 2024

我的访客大多来自中国大陆，他们访问其他国家的网速会很缓慢。这就是为什么我一直寻找
着能够自定义预览图和弹出大图尺寸的插件。其它的画廊插件通常不允许你自行设置这两个
尺寸。但这个插件，它选择爬取原版Wordpress超链接指向的图片，这是一种相当巧妙的方式！
而且它还提供了其它画廊插件所没有的缩放模块，我不敢相信这个插件目前的下载量只有仅仅
300… Most of my visitors are from mainland China, and their Internet speed to other
countries is very slow. That’s why I’ve been looking for plugins that can customize
the preview image and pop-up large image size. Other gallery plugins usually don’t
allow you to set these two sizes yourself. But this plugin chooses to crawl the 
pictures pointed to by the original WordPress hyperlink, which is a pretty clever
way! And it also provides a zoom module that other gallery plugins don’t have. I
can’t believe that this plugin has only 300 downloads at present…

![](https://secure.gravatar.com/avatar/e3d8f23d20c522e6e609e6ac92aa2d9b10d14a2ba4abd77e36cf68deb361ab4b?
s=60&d=retro&r=g)

### 󠀁[Simplicity and Functionality](https://wordpress.org/support/topic/simplicity-and-functionality-3/)󠁿

 [Cambabutonono](https://profiles.wordpress.org/cambabutonono/) ଅକ୍ଟୋବର 17, 2023

Why is this plugin great? Does what it says on the box. Integrates seamlessly with
standard WordPress functionality. Enhances the standard WordPress functionality 
without changing it – remove the plugin, and you’re back to standard WordPress without
missing or broken blocks. Does not create unnecessary menu items and popups. Does
not try to sell you anything. This plugin embodies the simplicity and functionality
that WordPress should offer, as opposed to the cluttered, ad-infested, slow, and
buggy alternatives out there.

![](https://secure.gravatar.com/avatar/bf4fe2197cc443f97962471b12281ab60453ee24f1bd4b76bade8f17472f81d4?
s=60&d=retro&r=g)

### 󠀁[works great](https://wordpress.org/support/topic/works-great-8911/)󠁿

 [iskradi](https://profiles.wordpress.org/iskradi/) ଅଗଷ୍ଟ 2, 2023

Plugin works great.

![](https://secure.gravatar.com/avatar/b94af65ef4e74785f9322ce28d431edef85aabdd4ed57b0defffba57215dfc93?
s=60&d=retro&r=g)

### 󠀁[Light and Right](https://wordpress.org/support/topic/light-and-right-2/)󠁿

 [Josh Journey](https://profiles.wordpress.org/ljosh/) ଜୁଲାଈ 18, 2021

Dead simple, super light weight and speedy. Pages load faster than other lightbox
plugins. Love the addition of navigating via arrow keys and works beautifully on
my touch screen monitor. Visually fantastic!

![](https://secure.gravatar.com/avatar/2d98e8b41711837259f40faa89e68183eb45fe4c45856771bcce9a0930ee7470?
s=60&d=retro&r=g)

### 󠀁[Wonderful plugin](https://wordpress.org/support/topic/wonderful-plugin-592/)󠁿

 [Naomi Blindeman](https://profiles.wordpress.org/naomiblindeman/) ଅକ୍ଟୋବର 30, 2020

I love how well this works! Great plugin: light, easy and very versatile. Very happy
with it.

 [ Read all 10 reviews ](https://wordpress.org/support/plugin/wp-imageviewer/reviews/)

## Contributors & Developers

“WP ImageViewer” is open source software. The following people have contributed 
to this plugin.

Contributors

 *   [ Marcel Pol ](https://profiles.wordpress.org/mpol/)

[Translate “WP ImageViewer” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-imageviewer)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wp-imageviewer/), check
out the [SVN repository](https://plugins.svn.wordpress.org/wp-imageviewer/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-imageviewer/)
by [RSS](https://plugins.trac.wordpress.org/log/wp-imageviewer/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 3.0.1

 * 2026-02-04
 * Fix arrow keys when viewer is inactive.

#### 3.0.0

 * 2026-01-13
 * Rewrite jQuery into vanilla JavaScript.
 * Support heif and avif images.
 * Remove wp_imageviewer_show_callback.

#### 2.0.7

 * 2024-11-15
 * Set z-index to 10000 for Twenty Twelve theme.

#### 2.0.6

 * 2022-10-28
 * Add callback for after showing an image.

#### 2.0.5

 * 2021-08-12
 * Add possibility to use custom options for the viewer.

#### 2.0.4

 * 2021-02-22
 * Fix deprecated jQuery calls with WP 5.6 and jQuery 3.5.

#### 2.0.3

 * 2020-11-03
 * Support images which have extra ?get parameters.

#### 2.0.2

 * 2020-10-19
 * Do not slide on touch when zoomed in.

#### 2.0.1

 * 2020-02-21
 * Fix check for active viewer.

#### 2.0.0

 * 2020-02-18
 * Update to upstream 2.0.0 iv-viewer.
 * Add navigation with arrow keys.
 * Only add hide-event to ‘body’ once, not for every image.
 * Only run expensive code when viewer is active.

#### 1.2.0

 * 2019-07-12
 * Support Enter and Esc key to open or close viewer.

#### 1.1.2

 * 2019-04-16
 * Do not swipe on multitouch.

#### 1.1.1

 * 2019-03-29
 * Add z-index to close button.

#### 1.1.0

 * 2019-03-11
 * Support touch events for swiping.

#### 1.0.2

 * 2019-01-03
 * Slightly bigger navigation buttons again, should be less sticky.

#### 1.0.1

 * 2018-12-01
 * Slightly bigger navigation buttons.
 * Add z-index to navigation.

#### 1.0.0

 * 2018-11-30
 * Initial release.

## Meta

 *  Version **3.0.1**
 *  Last updated **2 months ago**
 *  Active installations **700+**
 *  WordPress version ** 4.1 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.0 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/wp-imageviewer/)
 * Tags
 * [colorbox](https://ory.wordpress.org/plugins/tags/colorbox/)[fancybox](https://ory.wordpress.org/plugins/tags/fancybox/)
   [ImageViewer](https://ory.wordpress.org/plugins/tags/imageviewer/)[lightbox](https://ory.wordpress.org/plugins/tags/lightbox/)
 *  [Advanced View](https://ory.wordpress.org/plugins/wp-imageviewer/advanced/)

## Ratings

 4.9 out of 5 stars.

 *  [  9 5-star reviews     ](https://wordpress.org/support/plugin/wp-imageviewer/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/wp-imageviewer/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/wp-imageviewer/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/wp-imageviewer/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/wp-imageviewer/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/wp-imageviewer/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wp-imageviewer/reviews/)

## Contributors

 *   [ Marcel Pol ](https://profiles.wordpress.org/mpol/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wp-imageviewer/)