Shopify themes ship with an image banner and a collage section, but not a real gallery: no lightbox, no masonry, no tag filtering, and every image has to be placed by hand. This guide shows how to add a gallery to any page of an Online Store 2.0 theme (Dawn, Sense, Craft, Refresh and most paid themes) using an app block, so you never touch theme code.
What you need
An Online Store 2.0 theme (anything released since 2021; the theme editor shows an Apps category when you add a section or block) and the photos you want to show. JPG, PNG, WebP, GIF and AVIF up to 20 MB each work; MP4, MOV and WebM videos up to 250 MB do too.
Themes with the Canvas badge can't use app blocks yet; use your original theme without the badge or a copy of it made with Duplicate (not Duplicate in Canvas) on Online Store > Themes.
Snug Gallery's free plan covers one gallery of up to 25 images with every layout and the lightbox, so you can complete this guide without paying anything.
Step 1: install the app and create a gallery
- Install Snug Gallery from the Shopify App Store. It asks for permission to write files (to store your photos in your shop) and read products (for shop-the-look pins).
- Open the app from Apps in your admin and click New gallery. Give it a name such as “Spring shoot” and pick a layout: Masonry keeps each photo's proportions, Grid crops everything to one aspect ratio, Carousel scrolls horizontally.
- Upload your images (paid plans can also import them from existing products or from Shopify Files). Drag to reorder. Click any image to add alt text, a caption, a link and tags.
Step 2: place the gallery from the theme editor
- In the app, click Add to theme (or go to Online Store > Themes > Customize). Open the page where the gallery should appear.
- Click Add section (or Add block inside an existing section), open the Apps tab and choose Gallery from Snug Gallery.
- In the block settings, select the gallery you created. Set columns for desktop, tablet and phone, spacing, image shape, captions, hover effect and whether images open in a lightbox. The preview updates live.
- Click Save. The gallery is now on your storefront.
Step 3: check speed and accessibility
Because the gallery is rendered by a theme app extension, images are served from Shopify's CDN at the right size for each screen, exactly like your product photos. Run your page through PageSpeed Insights before and after: the gallery should not change your Largest Contentful Paint noticeably, and there is no third-party script waiting on another company's server.
Write alt text for every image in the gallery editor. Screen readers use it, and Google Images indexes it. Describe what is in the photo (“linen apron in sage green on a wooden counter”), not the file name.
Common questions
Can I put the same gallery on several pages? Yes, and one page can hold several gallery blocks, each with its own layout settings.
What happens if I uninstall the app? The block disappears from your pages and nothing is left behind in your theme. Your photos remain in Shopify Files, because they were uploaded to your own store.
Can shoppers filter photos? Add tags to images in the editor and turn on the Tag filter bar in the block settings. Visitors get pill buttons that filter the gallery without a page reload.
More guides
- Before and after photo gallery on a Shopify page
- Snug Gallery on Hydrogen or a headless Shopify store
- Galleries on a multilingual Shopify store: what translates
- Customer photos and GDPR: what a gallery app stores
- Video thumbnails in a Shopify gallery: pick the poster
- How to make a shoppable lookbook on Shopify
- Shopify gallery not loading? Why gallery apps vanish
- Cozy Image Gallery alternative: a 20-minute migration
- Who owns your gallery images? Shopify Files vs app-hosted
- Shopify app still charging after uninstall? What to do
- How to tell if a Shopify app is abandoned: a checklist
- Masonry, grid, carousel or collage: Shopify gallery layouts
- Accessible Shopify image gallery: an EAA-era checklist
- Instagram feed broken on Shopify? Own your customer photos
- Shopify video gallery: upload, YouTube or Vimeo?
- Protecting gallery images on Shopify: right-click blocking
- Does a photo gallery slow down your Shopify store?
- Shopify gallery images in Google Images: an SEO guide
- Shopify Canvas and Snug Gallery: what works today
- Build a Shopify gift guide page that is not a collection
- Replaced an image in Shopify but the old one still shows?
- Build a portfolio page on Shopify that still sells
- Link to a pre-filtered Shopify gallery from menus and emails
- Lifestyle photos on a product page: media or gallery block?
- Clickable gallery images on Shopify: link to collections
- Shopify Rollouts: launch a sale theme, discount and gallery
- Add a photo gallery to a Shopify blog post
- Gallery order on Shopify: manual, newest, A to Z or random
- Shop-the-look pins: sold out, unpublished and variant rules
- Pinterest save button on Shopify gallery images
- Custom CSS for a Shopify gallery block, safely scoped
- Gallery captions on Shopify: title, text, alt and placement
- Moderating customer photos: approve, reject, delete
- Gallery slider autoplay in Shopify: interval, pauses, motion
- Import images into a Shopify gallery from a URL
- Carousel or slider: picking the right Shopify gallery layout
- The customer photo form: what shoppers see, field by field
- Snug Gallery plans: what the limits mean in practice
- Gallery upload failed: every error message explained
- The gallery lightbox: keys, swipe, captions and video
- Reuse product photos and Shopify Files in a gallery
- Removing a gallery image: what is deleted, what stays
- Gallery tile says File missing: cause and fix
- Snug Gallery block settings: every option explained
- Switching Shopify themes: what happens to your galleries
- Transparent background images in a Shopify gallery
- iPhone HEIC photos in a Shopify gallery
- Gallery tags and the filter bar: limits, naming, order
- iPhone videos (MOV, HEVC) in a Shopify gallery
- Snug Gallery on an Arabic or Hebrew Shopify store
- Add a gallery to a Shopify collection, cart, 404 or blog
- Theme app add-ons: a Shopify gallery bundled with the theme
- Holiday customer photo contest on Shopify: gallery setup
- Press logos and an As seen in logo wall on Shopify
- Reviewing Snug Gallery in Shopify's Settings > Apps
- Shopify gallery image size and aspect ratio: a guide
- An About page photo gallery for your Shopify store
- A menu photo gallery for a cafe or bakery Shopify store
- Gallery photos and AI training: robots.txt on Shopify
- Which image formats work in a Shopify gallery (and why)
- Alternating image and text rows on Shopify: List layout
- An event recap photo gallery for your Shopify store
- Shopify gallery hover effects: zoom, lift, shine, grayscale
- Justified row gallery on Shopify: one line, no cropping
- Shopify collage gallery: which photos get the big tiles
- Shopify masonry gallery: what order do the photos go in?
- A stockists page on Shopify with shop photos, by city
- A sold archive gallery on Shopify for one-of-a-kind work
- Show gift wrap options on Shopify with a photo gallery