Guides

How to embed a high-resolution image in WordPress

Upload the image to ZoomHub, copy its embed code, and paste it into a Custom HTML block in the WordPress editor. Your post then shows a zoomable viewer with every pixel of the file, and it only loads the part on the screen.

Try it: the Earth at night

Satellite composite of the Earth at night, city lights tracing coastlines and rivers
Earth at night, 2012, 54,000 × 27,000 pixels. Zoom in: the Nile runs as a line of light through the dark desert.
HTML
<script src="https://zoomhub.net/a/f8kY5kAd3Gt.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. Copy the embed code

    When your image is ready, choose Embed on its page and copy the code: one line of HTML.

  4. Add a Custom HTML block

    In the WordPress editor, click the + button and choose Custom HTML, or type /html on a new line and press Enter.

  5. Paste the code and publish

    Paste the embed code into the block, then preview the post: the zoomable image appears where the block is. Publish when it looks right.

The facts

Who can add it
On your own WordPress site, Administrators and Editors can. WordPress removes scripts from posts by Authors and Contributors, and on a Multisite network only Super Admins can add them.
WordPress.com
Scripts need a paid plan with hosting features turned on, which installing a plugin does. On the free plan, the code is removed when you save, so link to the image instead.
Formats
JPEG, PNG, TIFF, WebP, GIF or PDF. A multi-page PDF becomes one zoomable document.
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

Why not upload the image to the Media Library?

By default, WordPress scales down uploaded images larger than 2,560 pixels, and the smaller copy becomes the largest your pages can show. A ZoomHub embed shows the image at its full size, and visitors only load the part they look at.

My embed disappeared when I saved. Why?

WordPress removes scripts unless your account may post unfiltered HTML: on your own site, that’s Administrators and Editors. On WordPress.com, the site needs a paid plan with hosting features turned on. Ask someone who can to add the block, or link to the image instead.

Do I need a plugin?

Not on your own WordPress site: the Custom HTML block comes with WordPress, and the embed is one line of HTML. On WordPress.com, installing any plugin is what turns on the hosting features a script needs.

Does it work on phones?

Yes. The viewer only streams the tiles on the screen, so a large image opens on a phone too. Visitors pinch to zoom. In an embed, two fingers move the image and one finger scrolls the page; on its own page or in full screen, one finger moves it.

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.