Guides

How to embed a high-resolution image in Squarespace

Upload the image to ZoomHub, copy its embed code, and paste it into a Code Block on any page or product. Visitors can then zoom into every pixel of the file, where Squarespace itself shows no image wider than 2,500 pixels.

Try it: a painting, stroke by stroke

Van Gogh’s swirling night sky over a sleeping village, with a dark cypress in the foreground
Vincent van Gogh, The Starry Night, 1889, 30,000 × 23,756 pixels. Zoom in: the brush strokes a 2,500-pixel copy blurs are all there.
HTML
<script src="https://zoomhub.net/a/uR0N.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 Code Block

    Edit the page, or a product’s Additional Info. Add a Code block, set its mode to HTML, paste the code and save. Then check the live page in a private window, since an embed can stay hidden while you’re logged in.

The facts

Plan
Scripts in a Code Block need the Core, Plus or Advanced plan. Basic doesn’t run scripts in a Code Block.
Squarespace’s own images
Squarespace takes uploads up to 20 MB and shows them at most 2,500 pixels wide. A ZoomHub embed shows the full file, however large.
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 Squarespace?

Squarespace makes copies of an upload at several widths, the largest 2,500 pixels, and the page shows those, so a scan or photo larger than that loses its fine detail. A ZoomHub embed shows the image at its full size, and visitors only load the part they look at.

Can I put it on a product page?

Yes: add the Code Block to the product’s Additional Info. Keep the product’s own photos too, since Squarespace uses them for the product grid, the cart and checkout.

My embed doesn’t show. Why?

Check that your plan runs scripts in a Code Block and that the block’s mode is HTML, then look at the live page in a private window: some embeds stay hidden while you’re logged in.

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.