Guides

How to put your collection online with zoomable images

Upload your scans or photographs to ZoomHub as one collection, make a gallery of it, and paste its one line of HTML into your website. You don’t need a IIIF server or an IT project: ZoomHub stores the images, and visitors zoom from the whole collection down to the finest detail of each object.

Try it: a collection of seven photographs

John F. Kennedy speaking at a lectern, officials and photographers around him
Seven NASA photographs of the Apollo program in one gallery, from President Kennedy’s visit in 1962 to Apollo 11 coming down under its parachutes. Open one and zoom in.
HTML
<script src="https://zoomhub.net/v/mj5LnxxNDp4.js?width=100%25&height=480px"></script>

Step by step

  1. Upload your images as one collection

    Sign in, then on the homepage choose your images or a whole folder. A folder keeps its order, numbers included, so scan 2 comes before scan 10. JPEG, PNG, TIFF, WebP or GIF all work.

  2. Describe each object

    On your dashboard, open an image’s Details and give it a title and a caption: the gallery shows them. Drag images to change their order.

  3. Make a gallery

    Open the collection on your dashboard and choose Create viewer. Pick a layout, justified, grid or strip, and choose whether captions show. The preview follows along. Copy the embed code when it looks right.

  4. Paste it into your website

    Paste the code where the gallery should appear: into your page’s HTML, or into an HTML or code block in your site builder. Change the gallery later and every page that embeds it follows.

  5. Give an object its own page

    Every image in the collection also has its own permanent link and its own embed. Paste one into an object’s page in your catalog, and it opens on that object alone.

The facts

Formats
JPEG, PNG, TIFF, WebP or GIF. A collection takes images only. A PDF goes up on its own and becomes a document.
File size
Up to 1 GB per file on Free, and 5 GB on paid plans.
Room
A collection holds as many images as your plan does. Free holds 10 images, Starter 50, Pro 200 and Business 1,000. Free is for personal use; commercial use needs a paid plan.
The gallery
See a gallery on its own page. Galleries come with every plan, with your choice of layout, captions and accent color. Slideshows are part of paid plans.
One object
The embed of a single image takes options for its size, its background and a minimap: see the embed options.
Who sees it
A new upload is Unlisted: only people with the link or a page that embeds it can see it. Choose Public to let search engines find it and, if you have a profile, to list it there. Password protection is part of paid plans.

Questions

Do I need a IIIF server?

No. ZoomHub tiles and hosts your images, so there’s no server to install or run. It doesn’t support IIIF, though: it has no IIIF Image API and no manifests. If you need to publish to IIIF viewers or aggregators, you still need a IIIF server for that. If your project needs IIIF, contact me: it helps me decide what to build next.

Do I have to move my catalog?

No. ZoomHub only holds the images, so your catalog or website stays where it is and embeds them. On the Pro and Business plans, each image can carry a reference ID, your own catalog number, to match it to its record.

Which plan does my collection need?

The one that holds all your images. Free holds 10 images, Starter 50, Pro 200 and Business 1,000. Each page of a PDF counts as an image. Past that, contact me for a price. Free is for personal use; commercial use needs a paid plan. A museum’s, archive’s or library’s website isn’t personal use, so it needs a paid plan however few images it shows. A paid plan also removes the “Powered by ZoomHub” badge.

Will ZoomHub change or compress my image?

No AI, no upscaling, and your full-size image isn’t resampled. PNG, TIFF and other lossless files stay pixel-exact, transparency kept; photos get high-quality JPEG tiles.

Can I keep some objects private?

Yes, on a paid plan. Select the images, choose Sharing and set a password: the images and their tiles stay locked until a visitor enters it. Select all the gallery’s images and set one password in a single step. Passwords set one image at a time, even identical ones, lock the gallery for everyone.