Product gallery settings

These settings control the product image gallery on your product pages. You'll find them in the Product information section under Gallery settings. For a guided walkthrough of choosing and setting up a layout, see Product information — this page is the setting-by-setting reference.

Desktop image aspect ratio / Mobile image aspect ratio — the shape images are cropped to. Adapt to image keeps each image's natural shape.

Desktop gallery style — the big one. Two columns puts the gallery beside the product details; Full width spans it across the page as a large slider. Several settings below only apply to one style or the other.

Show thumbnails (two columns, slider type) — small image previews for jumping through the gallery.

Gallery width (two columns) — the gallery's share of the page, as a percentage.

Gallery type (two columns) — how images are arranged: One column, One column first grid (first image enlarged), Two column grid, or Slider.

Gallery height (two columns) — Natural shows images at full size; Fit scales each image to fit the screen.

Desktop gallery position (two columns) — gallery on the left or right. On mobile the gallery always appears first.

Gallery variant image style — what the gallery does when a customer selects a variant: Default jumps to the variant's image, None ignores variant changes, Variant only shows only that variant's images. Requires variant images to be assigned in the Shopify admin — see How to assign variant images.

Gallery zoom style — Open in lightbox lets visitors click an image to view it fullscreen; None disables zoom.

Show video player controls — show or hide playback controls on videos in the gallery.

📝 Note: The gallery slider's animation, autoplay, arrows, and pagination live in the section's separate Slideshow settings group — see Slideshow control settings.