Every theme has an image with text section, and every merchant who has tried to tell a six-step story with it knows the routine: add the section, pick the photo, type the heading, type the paragraph, flip the image to the other side, then do it again five more times. The page ends up as six separate sections that each have their own spacing, their own image ratio and their own idea of where the heading sits. Reordering step three and step four means dragging sections around the theme editor. The List layout in Snug Gallery does the same job with one block. Each image gets a row, its caption sits beside it, and a single checkbox makes every second row swap sides. This guide covers how to set it up, what the layout does at each screen size, and when a row of theme sections is still the better tool.
What the List layout is
Most gallery layouts are built to show many images at once. List does the opposite. It stacks images in one column, one per row, and gives each caption real room: the caption title is set larger than body text and the caption text runs as a paragraph next to the picture. It is the layout for content where the words carry as much as the photo, such as how a product is made, a care routine, a room-by-room tour or a timeline of the brand.
On screens 750 pixels wide and up, each row is a pair: the image takes about 60 percent of the width and the caption about 35 percent, centred vertically against the image. Below 750 pixels the pair stacks, image first and caption underneath, so a phone visitor reads photo, heading, paragraph, photo, heading, paragraph. The space between rows is twice the Spacing between images setting, which keeps one step visually apart from the next without any extra dividers.
The layouts overview compares List with the other layouts in a paragraph each. This guide is the long version for the one layout that behaves like page content instead of a wall of tiles.
Alternate caption side: the zigzag
With the default settings every image sits on the left and every caption on the right. That reads cleanly but looks like a table after four or five rows. Turn on List: alternate caption side in the block settings and every second row is mirrored on desktop: image left, then image right, then left again. The eye moves down the page in a zigzag, which is the pattern people usually mean when they search for alternating image and text sections.
Two details are worth knowing. The alternation is by position, so it follows whatever order the gallery is in. Move an image up one place and its row flips sides along with everything below it; nothing has to be re-set by hand. And the alternation only applies on desktop widths. On a phone there are no sides, so the checkbox changes nothing there and the reading order stays image then caption for every row.
The setting does nothing in other layouts. If you switch the block from List to Grid to try something, the checkbox can stay ticked without side effects.
Set it up
- In the Snug Gallery app, create a gallery and upload one image per step or chapter. Six to ten rows is a comfortable length; past that, split the story over two pages.
- Open each image and fill in the caption title (the step name, for example "2. Cutting the leather") and the caption text (two to four sentences). Fill in alt text separately; it describes the photo and should not repeat the caption.
- Set the gallery's sort order to Manual and drag the images into reading order. The sort order guide explains why Manual is the only safe choice when sequence matters.
- In the theme editor, open the page template where the story belongs, add the Snug Gallery app block and pick the gallery.
- Set Layout to List and tick List: alternate caption side.
- Leave Caption style on anything except Hidden. In the List layout every visible style renders the same way, as text beside the image, so there is nothing to tune here.
- Pick one Image shape for the whole block, usually 4:3 or 1:1, so rows have the same height regardless of how each photo was shot.
- Preview at desktop and phone widths in the theme editor, then save.
Writing captions that work as body copy
In a grid, a caption is a label. In a list it is the article. A few habits make the difference between a page that reads well and a page of photo credits.
Write the title as the thing a skimmer needs: the step, the place, the year. Number the titles yourself if the order matters, because the layout does not add numbers. Keep titles to one line at desktop width, which in a 35 percent column is roughly 30 to 40 characters.
Caption text keeps its line breaks, so a caption can have two short paragraphs. It is plain text: no bold, no bullet lists and no links inside the paragraph. If a step needs a link, link the whole row instead. On paid plans each image can carry its own link, and in the List layout that makes the image and its caption one click target, which suits a row that ends with "see the finished bag". The captions guide covers the three text fields and where each appears.
Length matters more here than anywhere else in the gallery. A caption much taller than its image pushes the row out of balance on desktop, because the text is centred against the picture. Aim for a paragraph that is no taller than the image at laptop width; around 60 words next to a 4:3 photo is a good ceiling.
Images: shape, size and the lightbox
A zigzag looks deliberate when every image has the same shape and ragged when it does not. Set Image shape to a fixed ratio so portrait and landscape shots are cropped to match. If your photos have important content at the edges, crop them yourself before uploading so the automatic centre crop has nothing to cut off.
Because a List image fills more than half the content width on desktop, it is displayed larger than a grid tile. Upload at 2000 pixels on the long side or more; Shopify's CDN sends each visitor a smaller version sized for their screen, so a large original costs nothing in page weight. The image size guide has the numbers per layout.
Decide whether the lightbox earns its place. On a process page, tapping a photo to see it full screen is useful for detail shots. If rows carry links, the link wins and the lightbox does not open for those images, so a mixed page behaves inconsistently. Pick one: links on every row with the lightbox off, or no links and the lightbox on.
Hover effects still apply. Zoom is the default and can feel busy on images this large; None or Lift is calmer for editorial content.
When theme sections are still the better choice
The List layout is not a page builder, and it is better to know the edges before building a page on it.
Captions are plain text. If each row needs a button, a bulleted list of specs or a heading that is a real H2 for search engines, use your theme's image with text section for those rows. Caption titles are styled as headings but are not heading elements, so they do not create an outline for the page. Put the real H1 and any H2s in the page content above the block.
The split is fixed at roughly 60 and 35 percent. Themes often offer a 50/50 option or a narrow image with wide text. If the design calls for that, the theme section is the tool.
Where List wins is everything else: one place to edit all the rows, drag to reorder, one setting for image shape and spacing, the same content reusable on another page in a different layout, and no stack of six near-identical sections to keep consistent. A store that publishes a new "how it is made" story for each collection will feel that difference on the second page.
Three pages that suit it
How it is made. Six photos from raw material to packed order, each with a short paragraph. This is the classic use and the one that most often gets built from six theme sections today.
Care and use instructions. One row per step, with the photo showing the action. Phone visitors get a clean photo-then-instruction sequence, which is what most of them want when they arrive from a QR code on the packaging.
A brand timeline for the About page. Titles are years, captions are two sentences each. It pairs well with a team grid further down, as described in the About page gallery guide.
Frequently asked questions
How do I alternate image and text on a Shopify page without code?
Add one Snug Gallery block to the page, set Layout to List and tick List: alternate caption side. Each image becomes a row with its caption beside it, and every second row is mirrored on desktop. No theme code or custom CSS is needed.
What does the alternating layout look like on mobile?
Below 750 pixels wide each row stacks: the image on top and its caption title and text underneath. The alternate side setting has no effect on phones, so the order is always image then caption.
Can captions in the List layout contain links or bold text?
No. Caption title and caption text are plain text, and caption text keeps line breaks. To send visitors somewhere, add a link to the image itself on a paid plan; in the List layout the image and its caption are then one click target.
Do I have to set left and right for each image?
No. Sides are assigned by position: odd rows put the image on the left and even rows on the right. When you reorder the gallery, the sides update on their own.
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 add a photo gallery to a Shopify store (no code)
- 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)
- 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