Guides

How to embed a zoomable image that doesn’t hijack scrolling

Embed it with ZoomHub. Scrolling over the image moves the page as over any other picture, and visitors zoom with ⌘ or Ctrl and the scroll wheel, or by pinching. On phones, one finger scrolls the page and two fingers move the image. There is nothing to set: every embed works this way.

Try it: scroll past this map

Bird’s-eye engraving of Paris in which every street, garden and building is drawn
Turgot map of Paris, 1739, 35,690 × 28,030 pixels. Scroll over it and the page moves; hold ⌘ or Ctrl, or pinch, to zoom.
HTML
<script src="https://zoomhub.net/a/v48ah4T2Sm1.js?width=100%25&height=480px"></script>

Step by step

  1. Upload your image

    On the ZoomHub homepage, choose the file or paste a link to it. JPEG, PNG, TIFF, WebP, GIF or PDF all work.

  2. Confirm your email

    Enter your email address and open the link I send you. If you’re signed in, there’s nothing to confirm.

  3. Choose a link or an embed

    When your image is ready, its page has Link and Embed buttons: Link gives you a permanent address to share, and Embed gives you the code for your website.

  4. Paste it into your site

    Paste the embed code where the image should appear: into your page’s HTML, or into an HTML or code block in your site builder.

The facts

Mouse
The wheel scrolls the page. Holding ⌘ on a Mac, or Ctrl elsewhere, while turning it zooms the image. Dragging moves it, and the + and − buttons zoom too.
Trackpad
Two-finger scrolling moves the page, and pinching zooms the image.
Phones and tablets
One finger scrolls the page, as anywhere else on it. Two fingers move and zoom the image.
The hint
When someone scrolls or swipes over the image, a short hint shows how to zoom it instead. It stops showing once they’ve zoomed.
Full screen
The button in the corner opens the image full screen, where every gesture zooms and pans, since there’s no page left to scroll.
File size
Up to 1 GB per file on Free, and 5 GB on paid plans.
Cost
Free for personal use, up to 10 images. Commercial use needs a paid plan.

Questions

Can scrolling zoom the image instead?

Not in an embed: it would trap visitors who only want to read on. Full screen, and the image’s own page on ZoomHub, take every gesture. If your page shows nothing but the image, contact me: it helps me decide what to build next.

Why do other embedded maps and images zoom when I scroll?

Many viewers take every scroll over them, so a page with one stops scrolling whenever the pointer passes over it. Visitors then have to find a gap beside the viewer to get past it, which on a phone may not exist.

Does it work in WordPress, Squarespace and other site builders?

Yes. The behavior comes with the embed code, so it works wherever the code can be pasted, with nothing to configure.

Can I use it on a commercial site?

Yes, on a paid plan, which also removes the “Powered by ZoomHub” badge. Free is for personal use.