Docs

Embed options

One script tag puts a zoomable image on any web page. Replace {id} with your image’s ID — it’s in your upload email and in your image’s URL. Every option below is a query parameter you add to the script’s src.

HTML
<script src="https://zoomhub.net/a/{id}.js"></script>

Size & border

width and height accept whole-number pixel or percentage values — 500px, 100% — or auto. Defaults are width=auto and height=200px.

border=none removes the default thin frame around the viewer.

HTML
<script src="https://zoomhub.net/a/{id}.js?width=100%&height=400px&border=none"></script>

Fit

How the image fills the frame on load: contain (default) shows the whole image, letterboxing if the shapes differ; cover fills the frame edge to edge, cropping what doesn’t fit.

fit=containdefault
fit=cover
HTML
<script src="https://zoomhub.net/a/{id}.js?fit=cover"></script>

Zoom & pan limits

By default, visitors can pinch slightly past the fitted view and pan with a loose, elastic feel. constrain=zoom locks zoom-out at the fitted view while keeping the loose panning; constrain=full locks both — the frame stays filled with image, and its edges never come into view. Try dragging and zooming out in each preview.

constrain=zoom
constrain=full
HTML
<script src="https://zoomhub.net/a/{id}.js?constrain=full"></script>

Background

The color behind the image when it doesn’t fill the frame. black (default), white, or none — transparent, so your page’s own background shows through.

background=blackdefault
background=white
background=none
HTML
<script src="https://zoomhub.net/a/{id}.js?background=white"></script>

Minimap

Add minimap (or minimap=true) for a small overview map that tracks where the visitor is in the image — handy on large panoramas.

minimap
(no minimap)default
HTML
<script src="https://zoomhub.net/a/{id}.js?minimap"></script>

Combine options

Options chain with &, in any order.

fit=cover&constrain=full&minimap
HTML
<script src="https://zoomhub.net/a/{id}.js?height=400px&fit=cover&constrain=full&minimap"></script>