Title: Zoom OpenSeadragon
Author: Alexey Tikhonov
Published: <strong>February 5, 2016</strong>
Last modified: August 19, 2017

---

Search plugins

![](https://ps.w.org/zoom-openseadragon/assets/banner-772x250.jpg?rev=1343899)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/zoom-openseadragon/assets/icon-256x256.jpg?rev=1343899)

# Zoom OpenSeadragon

 By [Alexey Tikhonov](https://profiles.wordpress.org/altert/)

[Download](https://downloads.wordpress.org/plugin/zoom-openseadragon.1.4.zip)

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

 [Support](https://wordpress.org/support/plugin/zoom-openseadragon/)

## Description

Zoom OpenSeadragon is an implementation of [OpenSeadragon](http://openseadragon.github.io//),
an open-source, web-based viewer for high-resolution zoomable images, implemented
in pure JavaScript, for desktop and mobile.

It allows to create zoomable galleries from standart wordpress images as well as
from deepzoom images.

You can see [live demo here](http://altert.net/demo/openseadragon-zoom)

Zoom OpenSeadragon is released under the New BSD license

## Screenshots

[⌊Options for Zoom OpenSeadragon galleries. First gallery links to precreated DeepZoom
image, second and third use standart wordpress media files⌉⌊Options for Zoom OpenSeadragon
galleries. First gallery links to precreated DeepZoom image, second and third use
standart wordpress media files⌉[

Options for Zoom OpenSeadragon galleries. First gallery links to precreated DeepZoom
image, second and third use standart wordpress media files

[⌊Single zoomable image⌉⌊Single zoomable image⌉[

Single zoomable image

[⌊Tiled gallery, collection mode⌉⌊Tiled gallery, collection mode⌉[

Tiled gallery, collection mode

[⌊Sequence mode⌉⌊Sequence mode⌉[

Sequence mode

## Installation

Extract the zip file and just drop the contents in the wp-content/plugins/ directory
of your WordPress installation and then activate the Plugin from Plugins page.

To replace wordpress gallery with Zoom OpenSeadragon gallery you need to add `openseadragon
="true"` to gallery shortcode. You can also use Media options to replace all galleries
with Zoom OpenSeadragon gallery.

To show zoomable images, e.g. Deep Zoom images, you need to add paths of them to
zoomimages attribute of shortcode, for example

    ```
    [gallery openseadragon="true" zoomimages="/example.com/zoom/zoom1.dzi,/example.com/zoom/zoom2.dzi"]
    ```

Other attributes:

 * `width` – width of Seadragon Zoom, 600px by default
 * `height` – height of Seadragon Zoom, 600px by default
 * `columns` – number of columns in grid view
 * `noattachments` – do not use images, attached to post (for example, when you 
   need to display only DeepZoom images)
 * `captions` – display captions

Several OpenSeadragon parameters are also supported, see http://openseadragon.github.
io/docs/OpenSeadragon.html#Options for description of these parameters.

 * `shownavigationcontrol` – show zoom in/out/home/full buttons, true by default
 * `showzoomcontrol` – show zoom buttons, true by default
 * `showhomecontrol` – show home button, true by default
 * `showfullpagecontrol` – show fullscreen button, true by default
 * `showrotationcontrol` – show rotation buttons, false by default
 * `sequencemode` – display pictures in sequence mode, one by one instead of grid
 * `showsequencecontrol` – show next/prev buttons for sequence mode, true by default
 * `shownavigator` – show navigator minimap
 * `navigatorid` – id of navigator div, autocreated if left empty
 * `navigatorposition` – position of navigator minimap, TOP_RIGHT is default
 * `showreferencestrip` – show thumbnails of images, false by default
 * `referencestripsizeratio` – ratio of thumbnails sizes to deepzoom size, 0.2 by
   default
 * `referencestripposition` – position of reference strip, BOTTOM_LEFT by default
 * `referencestripscroll` – type of reference scroll, ‘horizontal’ by default

## FAQ

  Installation Instructions

Extract the zip file and just drop the contents in the wp-content/plugins/ directory
of your WordPress installation and then activate the Plugin from Plugins page.

To replace wordpress gallery with Zoom OpenSeadragon gallery you need to add `openseadragon
="true"` to gallery shortcode. You can also use Media options to replace all galleries
with Zoom OpenSeadragon gallery.

To show zoomable images, e.g. Deep Zoom images, you need to add paths of them to
zoomimages attribute of shortcode, for example

    ```
    [gallery openseadragon="true" zoomimages="/example.com/zoom/zoom1.dzi,/example.com/zoom/zoom2.dzi"]
    ```

Other attributes:

 * `width` – width of Seadragon Zoom, 600px by default
 * `height` – height of Seadragon Zoom, 600px by default
 * `columns` – number of columns in grid view
 * `noattachments` – do not use images, attached to post (for example, when you 
   need to display only DeepZoom images)
 * `captions` – display captions

Several OpenSeadragon parameters are also supported, see http://openseadragon.github.
io/docs/OpenSeadragon.html#Options for description of these parameters.

 * `shownavigationcontrol` – show zoom in/out/home/full buttons, true by default
 * `showzoomcontrol` – show zoom buttons, true by default
 * `showhomecontrol` – show home button, true by default
 * `showfullpagecontrol` – show fullscreen button, true by default
 * `showrotationcontrol` – show rotation buttons, false by default
 * `sequencemode` – display pictures in sequence mode, one by one instead of grid
 * `showsequencecontrol` – show next/prev buttons for sequence mode, true by default
 * `shownavigator` – show navigator minimap
 * `navigatorid` – id of navigator div, autocreated if left empty
 * `navigatorposition` – position of navigator minimap, TOP_RIGHT is default
 * `showreferencestrip` – show thumbnails of images, false by default
 * `referencestripsizeratio` – ratio of thumbnails sizes to deepzoom size, 0.2 by
   default
 * `referencestripposition` – position of reference strip, BOTTOM_LEFT by default
 * `referencestripscroll` – type of reference scroll, ‘horizontal’ by default

  How to replace specific gallery with Zoom OpenSeadragon gallery?

To replace wordpress gallery with Zoom OpenSeadragon you need to add openseadragon
=”true” to gallery shortcode.

  How to replace all galleries with Zoom OpenSeadragon gallery?

Use Zoom OpenSeadragon Options section in Settings => Media.

  How to create really big zoomable image?

See http://openseadragon.github.io/examples/creating-zooming-images/

## Reviews

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

### 󠀁[Works perfectly with some limitations](https://wordpress.org/support/topic/works-perfectly-with-some-limitations/)󠁿

 [Gjwj27wnw](https://profiles.wordpress.org/camdey/) March 24, 2021

Easy to implement, works great, and is very fast and smooth to use on PC or mobile.
There are some limitations, for example I haven’t been able to get it to work responsively.
I can set width=”” and the width will adjust according to window size but I haven’t
been able to do the same for the height yet. Either way, it’s free and works as 
expected!

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

### 󠀁[Awesome!](https://wordpress.org/support/topic/awesome-7905/)󠁿

 [pathvader](https://profiles.wordpress.org/pathvader/) July 6, 2020

Awesome plugin.

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

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

 [rafaelmarwp](https://profiles.wordpress.org/rafaelmarwp/) February 28, 2018

It is simply a wonderful and extremely useful plugin. By adding a few lines of code
to a post you can have zoomable images. My website features many historic photographs
and the ability to zoom in and see details is simply incredible. Keep up the good
work!

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

### 󠀁[Simple, easy, perfect.](https://wordpress.org/support/topic/simple-easy-perfect-3/)󠁿

 [Tilman](https://profiles.wordpress.org/archeryimagesnet/) May 22, 2017

Pretty easy plugin, much easier than pasting javascript into my posts. Thanks a 
lot, works like a charm, keep up the good work!

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

### 󠀁[Simple, fast & slick [5/5]](https://wordpress.org/support/topic/simple-fast-slick-55/)󠁿

 [photoMaldives](https://profiles.wordpress.org/photomaldives/) September 3, 2016

I searched for quite a while to find a ‘zoom’ plugin that did what I wanted with
little fuss, and tried various plugins before settling on this one. I am impressed
by how quickly this loads on my page, and how smooth the zooming and navigation 
are. I had a small issue, and Alexey the plugin developer issued a fix within a 
few days – good work. 🙂 I just needed a little css for my theme, with this simple
shortcode (if it helps anyone) – [gallery ids="331,328" openseadragon="true" width
="1076"] Use WP editor to add a gallery as normal, then edit the shortcode to add
in the openseadragon parameters.

 [ Read all 5 reviews ](https://wordpress.org/support/plugin/zoom-openseadragon/reviews/)

## Contributors & Developers

“Zoom OpenSeadragon” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Alexey Tikhonov ](https://profiles.wordpress.org/altert/)

“Zoom OpenSeadragon” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/zoom-openseadragon/contributors)
for their contributions.

[Translate “Zoom OpenSeadragon” into your language.](https://translate.wordpress.org/projects/wp-plugins/zoom-openseadragon)

### Interested in development?

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

## Changelog

#### 1.4

 * Updated OpenSeadragon library to version 2.3.0 and changed script to go to photo
   in multiimage configuration accordingly

#### 1.3

 * Updated OpenSeadragon library to version 2.2.0

#### 1.2

 * Fixed reading of attachment sizes

#### 1.1

 * Updated Russian localization

#### 1.0

 * Initial release

## Meta

 *  Version **1.4**
 *  Last updated **9 years ago**
 *  Active installations **100+**
 *  WordPress version ** 4.0.0 or higher **
 *  Tested up to **4.8.28**
 *  Languages
 * [English (US)](https://wordpress.org/plugins/zoom-openseadragon/) and [German](https://de.wordpress.org/plugins/zoom-openseadragon/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/zoom-openseadragon)
 * Tags
 * [gallery](https://wordpress.org/plugins/tags/gallery/)[pyramid](https://wordpress.org/plugins/tags/pyramid/)
   [tiles](https://wordpress.org/plugins/tags/tiles/)[zoom](https://wordpress.org/plugins/tags/zoom/)
 *  [Advanced View](https://wordpress.org/plugins/zoom-openseadragon/advanced/)

## Ratings

 5 out of 5 stars.

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

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

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

## Contributors

 *   [ Alexey Tikhonov ](https://profiles.wordpress.org/altert/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/zoom-openseadragon/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://altert.net/demo/donate/)