How to Create a Masonry Gallery in the WordPress Block Editor (Gutenberg)

Image Resolution

Choose between Thumbnail, Medium, Large, or Full resolution images, this gives you control over both image quality and page load speed.

Columns and Remove Image Gap

The Masonry Gallery Block is fully responsive. You can define separate column counts for Desktop, Tablet, and Mobile, ensuring your galleries always look balanced. You can also choose to disable the gaps entirely for a flush, edge-to-edge look.

Randomize Image Order

Allows you to shuffle image order dynamically, giving returning visitors a fresh viewing experience each time the page loads.

Selecting WooCommerce Product from the Image Click Behavior dropdown will allow you to link the gallery images to WooCommerce products in your WordPress website. Linking is done on the individual Image blocks from a search field that is added to their Settings panel.

Note: Option will only be available when the WooCommerce plugin is installed and active. Images that are not linked will not have an empty hyperlink added.

The Default Product Link Behavior dropdown allows to decide if you want the link to add a product to your shopping cart or if you want the link to go to the selected product’s page.

The Link Target dropdown allows to decide if you want the link to be placed on an icon or on the thumbnail image. The Display Add To Cart Icon drop down allows you select if the Link icon is always visible or only visible on hover.

Note: With WooCommerce Product selected an additional control is added into the gallery block’s Styles panel. This control allows you to set the color of the Add To Cart icon as well as its background color.

Finally the Enable Lightbox control allows you to toggle the Lightbox on and off. This is only available when the Link Target dropdown set to Link Target Icon. With Enable Lightbox activated a further control allows you set what displays in the Lightbox alongside the image. With Image Title, Caption, EXIF Data, and WooProduct details being options.

From the Gallery Hover Settings panel you can set if images will display an overlay when you hover over them. The Hover Style dropdown allows you to select from a Blur, Fade, Gradient, Chip, or Color Overlay.

Notes: With the Color Overlay selected you can additionally customize the color of the text and background of the Overlay by going to the Styles panel and the Gallery Hover Styles section.

The Overlay Content drop down allows you to select what displays inside the overlay when you hover above an image. You can select from Show Image Title, Show Image Caption, Show EXIF Data, or Show Product Info.

Notes: Show Product Info option is only available when gallery is linked to WooCommerce.

Enable Image Filtering

When filtering is enabled, you can assign categories to images (e.g., “Sports,” “Portraits,” “Events”) and allow visitors to toggle between them.

First you have the Filter Bar Alignment settings which allows you set the alignment of the bar with your added categories (e.g., “All, Sports, Portraits, Events”).

Then you have the Filter Categories input. Here you can add your filter categories (e.g. “Portraits, Events, Landscape”) separated by commas.

Once you have added your categories you can now select the individual images inside your Masonry Gallery Block and in their block settings there will be a new Filter Categories dropdown select control where you can apply one of the categories to the image.

Note: Additional style options for the Filter Bar are available in the blocks style settings panel.

Disable Right-Click on Page

Attempts to disable right-click on the page to discourage casual image downloads.

Note: The “Disable Right-Click” feature helps discourage casual users from saving your images, but it cannot fully prevent access to image files through browser tools or the page source.

Enable Lazy-Load of Images

When lazy load is enabled, images only load as the visitor scrolls, improving page load speed.

Background

The Background setting allows you to customize the backdrop behind your Modular Gallery block. You can choose any color from your theme palette or define a custom color to help your images stand out or blend seamlessly with the surrounding layout.

A subtle background tone can make white borders or drop shadows more visible, while a dark background often enhances contrast and gives a cinematic look.

Dimensions – Padding & Margin

The Padding and Margin controls give you fine-grained control over the spacing inside and around your Masonry Gallery block.

Use Padding to create breathing room between your gallery content and its edges — useful for highlighting the gallery within a colored background.

Use Margin to control the outer spacing between the gallery and adjacent blocks or page sections, ensuring perfect alignment and balance within your overall page design.

Border Color, Width, & Radius

These settings allow you to add custom borders to the images in your gallery. Select the color of your border and then adjust the border width slider to your liking.

The images in the editor update in real time so you can see how they look without having to visit the front end of the site.

Border Radius slider allows you to add a radius to the corner of the images to further create special effects.

Enable Drop Shadow

Enable Drop Shadow adds a subtle drop shadow to your images that helps them pop off the page.