Updated: May 28th, 2026 for FolioBlocks Version 1.3
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.
Table of Contents
What Is the Modular Gallery Block?
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
How to Add the Modular Gallery Block
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.

2. Building the Gallery with Image Rows & Image Stacks
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.

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:

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

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.

General Gallery Settings
Image Resolution
Choose between Thumbnail, Medium, Large, 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.

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

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.

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.
Link Image to Page/Post
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.

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.
Gallery Hover Settings
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.

Advanced Gallery 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.
Gallery Styles 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 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.

Gallery Image Styles

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