Lightbox: Zoom

1 min read

Updated May 20, 2026

FotoGrids includes a built-in zoom feature that lets visitors inspect items at higher detail directly inside the Lightbox. Zoom is activated by click, double-click, scroll wheel, or pinch gesture — and can optionally be surfaced with dedicated toolbar buttons.

Location Gallery Settings Interactions Lightbox Settings Advanced


Enable Image Zoom #

SettingEnable Image Zoom
DefaultOn

Enables the zoom feature for the Lightbox. When on, visitors can zoom into any item using the configured trigger. When off, all zoom controls and toolbar buttons are hidden.


Zoom Trigger #

SettingZoom Trigger
OptionsDouble-Click Click Scroll & Pinch Only
DefaultDouble-Click
Visible whenEnable Image Zoom is on

How a visitor activates zoom on an item.

  • Double-Click — Double-clicking the item zooms to 2× and centers on the click point. Double-clicking again resets to 1×.
  • Click — A single click toggles zoom. A click is ignored if the pointer moved more than 5px during the gesture, to allow drag/pan without accidentally triggering zoom.
  • Scroll & Pinch Only — Zoom is only activated by mouse scroll wheel or touch pinch. Click has no zoom effect.

Regardless of the Zoom Trigger setting, mouse wheel scroll and two-finger pinch always control zoom whenever the feature is enabled.


Show Zoom Buttons #

SettingShow Zoom Buttons
DefaultOff
Visible whenEnable Image Zoom is on

Adds dedicated Zoom In (+) and Zoom Out (−) buttons to the Lightbox toolbar. Each press changes the zoom level by 0.25× (e.g. 1× → 1.25× → 1.5×…). Useful when zoom discoverability matters — for example, in a product photography gallery.


Allow Zooming Beyond Original Size #

SettingAllow Zooming Beyond Original Size
DefaultOn
Visible whenEnable Image Zoom is on

When on, visitors can zoom up to 4× regardless of the image’s actual resolution. The image may appear soft or pixellated at high zoom levels on large displays.

When off, the maximum zoom is capped at the image’s natural pixel density — so a 1200px image displayed at 400px can zoom to a maximum of 3× before the limit is reached. This prevents pixellation for visitors inspecting fine detail.


Zoom Behavior Reference #

  • Minimum zoom: 1× (normal view, fully zoomed out)
  • Maximum zoom: 4× (or natural pixel density if Allow Zooming Beyond Original Size is off)
  • Step size: 0.25× per button click or scroll tick
  • Double-click zoom level: 2×, centered on the clicked point
  • Pan while zoomed: Visitors can click and drag to pan around the item. Edges are clamped so the Lightbox frame never shows empty space.
  • Reset on navigate: Zoom resets to 1× automatically when the visitor moves to a different item.
Was this article helpful?