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
<script src="https://zoomhub.net/a/f8kY5kAd3Gt.js?width=100%25&height=480px"></script>
Step by step
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.
Confirm your email
Enter your email address and open the link I send you. If you’re signed in, there’s nothing to confirm.
Copy the embed code
When your image is ready, choose Embed on its page and copy the code: one line of HTML.
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.
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.
