The Image Grid display format renders an ACF Gallery field’s images in a responsive multi-column grid. The number of columns adapts per breakpoint, and each tile crops to a chosen aspect ratio so the rows align cleanly regardless of the source images’ sizes.
The format is well-suited to product galleries, portfolios, and any photo collection where consistent tile dimensions matter.
Supported Field Types
The Image Grid display format supports the following field types:
- Gallery
Customization
Sidebar controls cover the column count, the click behavior, the per-tile aspect ratio and scale, and the spacing between images.
| Customization | Description | Note |
|---|---|---|
| Column count | Number of columns per breakpoint (desktop / tablet / mobile). Range: 1–8. | |
| On click action | What happens when a visitor clicks a tile. Options: Do nothing, View in lightbox, View full size on same tab, View full size on new tab. | |
| Image spacing | Pixel gap between adjacent tiles. Range: 0–100. | |
| Aspect Ratio | Fixed ratio every tile crops to. Options include “Original” plus the theme’s and WordPress’s default ratios. | |
| Scale | How each image fits its tile. Options: Cover, Contain, Fill. | Only available when a non-“Original” Aspect Ratio is set. |
| Resolution | Which registered image size (thumbnail, medium, large, full, or any custom size) is loaded as the src. | |
| Empty Message | Toggle (“Show message if empty”) plus fallback text shown when the gallery has no images. | |
| Layout Variations | Switch the variation in the inspector to render the same gallery as a carousel or masonry layout instead of a grid. | The Grid / Carousel / Masonry variations share the same underlying block — switching only changes the type attribute. |
The block also supports the following standard WordPress block controls: Block Alignment (wide, full), Border (color, width, radius applied to each tile’s <img>), Margin, Padding, and a Duotone Filter applied to every image.