Skip to main content

Image Gallery

An image gallery component acts as a way to present a collection of thematically related images.

When To Use This Component

This component should be used when you want to display a body of related images in a grid or masonry-style format. It allows you to present up to 24 images, giving you the flexibility to tell a well-rounded story or showcase multiple perspectives on a topic, event, or subject area.

USE CASES OR SCENARIOS

The Image Gallery block works best when images contribute meaningfully to the page’s message and help users better understand the subject.


Component Dos & Don’ts

There might be a time when you don’t know whether to use an image gallery component or not. Here are some examples of how to effectively use an image gallery component and when you shouldn’t use one:

DO

When using the Image Gallery block, select high-quality, relevant images that directly support the page content, and limit the number of images to only what is necessary to avoid overwhelming users. Ensure every image includes clear, descriptive alt text to meet accessibility standards. Maintain visual consistency across the gallery by using images with similar styles, lighting, and subject matter, and place the gallery near related content so users can easily understand its context and purpose.

DON’T

Avoid using image galleries purely for decoration; every image should add meaningful value to the page content. Do not include images that contain embedded text that cannot be read by screen readers, as this creates accessibility barriers. Keep galleries focused by grouping only related images together, and avoid duplicating content by displaying the same images across multiple pages. The Image Gallery block is intended specifically for displaying multiple images, not videos. If you want images to be presented one at a time, use the Carousel component instead, and if only a single image is needed, use the Image or Big Image/Video component rather than a gallery.


Component Design Options

Below are the Image Gallery component design options, with explanations of each and guidance on proper usage.

EDITABLE PARTS:


The example below shows the Image Card in use, along with the selected configuration options.