Skip to main content

Image Gallery

Learn how to showcase images in a gallery format.

Overview

Image gallery shows 2 to 30 images as a slideshow. Visitors see one large image at a time and move between images using the arrows or the thumbnails below. Use it to share photos from an event or a set of related images without making your page very long.

Where you can use it:

  • Available on: Standard layout pages, article layout pages, overview pages and database pages

  • Not available on: Homepage

For a single image, use the Image block instead.

What your website visitors see:

  • On desktops, a large image with 5 thumbnails below it.

  • On tablets, a large image with 3 thumbnails below it.

  • On phones, a large image with arrows only, and no thumbnails.

Add and set up Image gallery

  1. On your page, select Add block, then select Image gallery ("Display up to 30 images in a slideshow"). The block starts with three placeholder images.

  2. For each image:

    • Upload your image.

    • Add alternate text that describes the image. Isomer Studio won't accept generic words such as "image" or "photo".

    • Add a Caption if needed, for example to describe the moment or credit the photographer.

  3. Add or remove images as needed. Each gallery needs at least 2 images and can have up to 30. Images appear in the slideshow in the order they're listed.

  4. Select Save block.

Prepare your images

Recommended dimensions

Aspect ratio

At least 960 × 640 pixels

Your image's own shape, not cropped

Image gallery always shows your whole image and never crops it. If an image's shape doesn't match the frame, white space fills the gap at the sides or the top and bottom.

Landscape images fill the frame best. Portrait images appear narrow, with wide white space on both sides.

Captions sit on a dark band over the bottom of the image, so keep important details away from the bottom edge.

Best practices

  • Use the same shape for every image. Mixing landscape and portrait images makes the white space change size as visitors move through the slideshow, which looks untidy.

  • Put your strongest image first. It's the only image visitors see without interacting with the gallery, and many won't go further.

  • Choose a few strong images over many similar ones. Visitors rarely click through a long slideshow. If several photos show the same moment, keep the best one.

  • Keep captions short. Captions longer than 3 lines are cut off, and phones fit fewer words per line.

  • Don't repeat the caption in the alternate text. Screen readers read both, so use alternate text to describe what the image shows and the caption for context or credits.

Limitations and things to note

  • No links or zoom. Images can't link to another page, and visitors can't open them full screen.

  • No autoplay. The slideshow only moves when a visitor selects an arrow or thumbnail.

  • Captions are plain text. You can't add links or formatting to a caption.

Did this answer your question?