Snug Gallery / Guides

Alternating image and text rows on Shopify: List layout

Build a zigzag of photos and paragraphs on a Shopify page with one gallery block: the List layout, alternate caption side, and what happens on phones.

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

  1. 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.
  2. 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.
  3. 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.
  4. In the theme editor, open the page template where the story belongs, add the Snug Gallery app block and pick the gallery.
  5. Set Layout to List and tick List: alternate caption side.
  6. 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.
  7. 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.
  8. 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