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

Resolution

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

Columns

The Masonry Gallery Block is fully responsive. You can define separate column counts for Desktop, Tablet, and Mobile, ensuring your galleries always look balanced.

Gap Between Items

The Gap Between Items slider allows you to define the amount of space between images with options to set different values for Desktop, Tablet, and Mobile.

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 drop down 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 displayed, displayed on hover, or never displayed.

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 and activate the Lightbox, when activated will display additional Lightbox controls for Lightbox Appearance and Lightbox Content.

Note: This is only available when the Link Target dropdown set to Link Target Icon.

When the Image Click Behavior setting on the gallery block is set to WooCommerce Product, you can then select any individual Image Block within the gallery and link it directly to a product in your WooCommerce store.

To do this, open the Image Block’s Settings panel and expand the Image Click Settings panel. There you’ll find a searchable field that lets you quickly find and select any product from your WooCommerce catalog.

For faster access, a Shopping Cart button is also available in the Image Block toolbar. Clicking this button opens the same product selection interface.

From the Gallery Hover Settings panel you can set if images will display an overlay when you hover over them.

Hover Style

The Hover Style dropdown allows you to select from:

• None
• Fade Overlay
• Gradient Bottom
• Chip
• Color Overlay

Notes: With the Color Overlay or Chip 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.

Overlay Content

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
• Show Product Info

Notes: Show Product Info option is only available when gallery or image 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 gallery Block and in their block Content panel there will be a new Filter Categories panel where you can apply one or more of the categories to the image.

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

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.

Drop Shadow

The Drop Shadow dropdown allows you to select from a variety of Drop Shadow effects and apply them to the thumbnail images in your gallery. You can select from the following types of Drop Shadow:

• None
• Subtle
• Soft
• Elevated
• Dramatic

When Enable Image Filtering is active the Filter Bar Styles panel will be present in the Grid Gallery Block’s style panel.

Font-Family, Font Size, Appearance, Line Height, Letter Spacing, Decoration, & Letter Case

When using a block based theme that uses theme.json FolioBlocks will detect available fonts and let you set the font for the Filter Bar. Additional controls allow you to set Font Size, Appearance, Line Height, Letter Spacing, Decoration, and Letter Case styles.

Active – Text Color & Active – Background Color

These two settings allow you to set the color and background color for the active term in the Filter Bar.

Inactive – Text Color & Inactive – Background Color

These two settings allow you to set the color and background color for the inactive terms in the Filter Bar.

Note: The font used in the Filter Bar for Active and Inactive terms is pulled from your theme’s body font.

Starting with FolioBlocks 1.4, individual Image Blocks within the any gallery block can now override the gallery’s default Click Settings and Hover Settings.

Simply select an image inside the gallery and enable either Override Gallery Click Settings or Override Gallery Hover Settings in the Image Block settings panel. Once enabled, the same controls available at the gallery level become available for that specific image, allowing you to customize its behavior independently of the rest of the gallery.

This feature unlocks a new level of creative flexibility. For example, you can create a gallery where most images open in the Lightbox, while selected images link to pages, posts, external URLs, or WooCommerce products. You can also mix and match hover effects, giving individual images their own overlay colors, metadata displays, animations, and interactive behaviors.

The result is a gallery experience that can be tailored on an image-by-image basis, making it easier than ever to highlight important content, guide visitors through your site, or create more engaging visual layouts.

Password Protect Page

Requires a password before visitors can view the page.

Disable Right-Click on Page

Attempts to disable right-click to discourage casual image downloads.

Note: This makes it harder for casual users to save images, but it’s not foolproof — advanced users can still access media via the browser’s developer tools or view source.

Enable Lazy-Load of Images

When active, images load as the user scrolls, improving initial page load speed.