Modular Gallery Block for WordPress: Professional Photo Layouts Made Easy

Modular Gallery Block for WordPress: Professional Photo Layouts Made Easy

The Modular Gallery Block in FolioBlocks lets you create visually striking, magazine-style photo layouts directly inside the WordPress Block Editor (Gutenberg). It combines the precision of the Justified layout with the flexibility of custom image rows and image stacks, giving you complete creative control over how your images are arranged.

Note: The Modular Gallery Block is only included in the paid (Pro) version of FolioBlocks.


The Modular Gallery Block is a unique, row-based gallery system that allows you to build your gallery section by section. Each row is made up of images that automatically scale to fill the full width of the page, maintaining their original aspect ratios — much like a justified gallery — but with the added ability to group and design each row individually.

This layout style is inspired by editorial photo essays and magazine spreads, where visual storytelling depends on rhythm and structure. It’s ideal for photographers who want to build customized, narrative-driven galleries rather than uniform grids.

Perfect for:

  • Portfolio showcases with varied image groupings
  • Editorial or storytelling layouts
  • Magazine or publication-style photo features
  • Hero galleries and homepage sections

1. Insert the Block

In the WordPress Block Editor, click the ➕ Add Block button and search for “Modular Gallery.” You’ll find it under the FolioBlocks section.

The Modular Gallery Block is unique in that you construct your gallery an image at a time. With the block added into the Editor you are prompted to select your first image.

Initial placeholder added by the Modular Gallery Block.

When you have added your first image you will notice that it has filled out the entire width of the gallery as in the example bellow:

Images added into Image Rows will always fill the full width of the row.

If you example the Modular Gallery Block’s structure in the List View you will see that your image has been added inside of an Image Row. An Image Row will always fill out edge to edge. Since we only have one image in our row it filled out the entire width of the row.

Lets add a second image into the Image Row:

With a second image added into the Image Row both images have resized as to fill the full width of the row.

With a second image added you see it and our original image have been resized in order to fill out the row edge to edge.

Now let’s take it a step further, inside of your Image Rows you can also add an Image Stack. An Image Stack is similar to an image row only that images place inside of it are stacked one on top of another. The Image Row views the Image Stack as a singular unit and resizes it so it can fill out the row with the other images.

In the example below we have added an Image Stack into our original Image Row and inside of the Image Stack with have added two images.

Adding an Image Stack into an Image Row allows you to add images that stack on top of one another.

This combination of Image Rows and Image Stacks allows you to construct a wide variety of layouts where you give visual preference in terms of size to images of you see fit.

3. Arrange and Customize

Like all the other galleries in FolioBlocks, the Modular Gallery displays images as inner blocks this means that the List View makes it super easy to re-arrange your gallery and modify your layout. Images can be dragged and dropped in and out of Image Rows and Image Stacks. Image Stacks can also be dragged and dropped from one Image Row to another.


Image Resolution

Choose between ThumbnailMediumLarge, or Full image resolutions to optimize quality and performance.

Collapse layout on Mobile

The Modular Gallery Block by default will maintain it’s layout even on Mobile phones, the idea being that it might be often used on presentational galleries where the size of the image is meant to convey a message.

Activate this toogle if you prefer for it to collapse into a single column of images on mobile.

Remove Image Gap

Toggle removes gaps between images and rows.

Modular Gallery Block - General Gallery Settings

Gallery Click Settings

As of version 1.3 of FolioBlocks all features related to what happens when you click on a gallery images are grouped into a panel called Gallery Click Settings. Clicking on the Image Click Behavior drop down reveals the following options: None, Open in Lightbox, Enable Image Downloads, Link Image to Media File, Link Image to Custom URL, Link Image to Page/Post, or WooCommerce Product.

Note: WooCommerce Product only displays is WooCommerce is installed and active

Selecting Open in Lightbox in the Image Click Behavior dropdown will activate the Lightbox on the website’s front-end. The Lightbox supports keyboard navigation and swipe gestures.

When Open in Lightbox is selected in Image Click Behavior An additional dropdown titled “Lightbox Content” allows you to select what displays inside of the Lightbox alongside the image. You can select from: None, Show Image Title, Show Image Caption, or Show EXIF Data.

Gallery Click Settings - Open in Lightbox

Enable Image Downloads

Gallery Click Settings - Enable Image Downloads

Selecting Enable Image Downloads in the Image Click Behavior dropdown will make all of the gallery images link to the source file so they are available for download in the front-end of the website.

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 Image Download Icon drop down allows you select if the Download icon is always visible or only visible on hover.

Note: With Enable Image Downloads selected an additional control is added into the gallery block’s Styles panel. This control allows you to set the color of the Download 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 Image downloads are 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, and EXIF Data being options.

Link Image to Media File

Selecting Link Image to Media File in the Image Click Behavior dropdown will make all the gallery thumbnails link to their source file. However clicking the link will not trigger a download but open the source file in the browser.

This setting is useful is you want to use a 3rd party Lightbox rather than the Lightbox that is included with FolioBlocks.

Gallery Click Settings - Link to Media File
Gallery Click Settings - Link Image to Custom URL

Selecting Link Image to Custom URL in the Image Click Behavior dropdown will allow you to link the gallery images to custom urls. Linking is done on the individual Image blocks from a search field that is added to their Settings panel.

Note: Images that are not linked will not have an empty hyperlink added.

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 Link Target Icon drop down allows you select if the Link icon is always visible or only visible on hover.

Note: With Link Image to Custom URL selected an additional control is added into the gallery block’s Styles panel. This control allows you to set the color of the Link 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 Image downloads are 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, and EXIF Data being options.

Selecting Link Image to Page/Post in the Image Click Behavior dropdown will allow you to link the gallery images to Pages or Posts on your WordPress site. Linking is done on the individual Image blocks from a search field that is added to their Settings panel.

Note: Images that are not linked will not have an empty hyperlink added.

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 Link Target Icon drop down allows you select if the Link icon is always visible or only visible on hover.

Note: With Link Image to Page/Post selected an additional control is added into the gallery block’s Styles panel. This control allows you to set the color of the Link 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 Image downloads are 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, and EXIF Data being options.

Gallery Click Settings - Link Image to Page/Post

WooCommerce Product

Gallery Click Settings - WooCommerce Product

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.

Gallery Hover Settings

Disable Right-Click on Page

Blocks right-click functionality to discourage casual saving or copying of your images.

Note: This feature helps deter casual downloads but cannot fully prevent access through browser developer tools or source code.

Enable Lazy-Load of Images

Loads images as they appear on screen to improve page performance on large galleries.


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 Modular 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.


The Gallery Image Styles panel in the Modular Gallery Block.

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.


Bellow is an example of the Modular Gallery created with FolioBlocks:


Common Questions

How many images can I add?

Image Rows support up to 8 images and Image Stacks support up to 4 images.

Can I reorder or replace images?

Yes — you can drag to reorder images within each row or rearrange entire rows via the List View panel. Images can be dragged from one row to another and in and out of Image Stacks.

Does it work with my theme?

For the best experience it is recommended to use a block based theme. However FolioBlocks does work with classic themes provided they support wp_block_styles and the block editor.

Is it compatible with WordPress 6.x or newer?

Yes. The Modular Gallery Block is built for the WordPress Block Editor (Gutenberg) and optimized for modern WordPress standards.


Get Started

Ready to design your first modular gallery? Get FolioBlocks and start building professional, story-driven photo layouts in the WordPress Block Editor today.