Create amazing image & video galleries inside the block editor
FolioBlocks is a modern gallery and portfolio plugin built specifically for the WordPress Block Editor (Gutenberg) and Full Site Editor. Designed for photographers, designers, artists, and creative professionals, FolioBlocks makes it easy to create beautiful, fully responsive image galleries, video galleries, and before-and-after comparison blocks—all without shortcodes or external gallery systems.
Build professional galleries directly inside Gutenberg using flexible layouts including Grid, Justified, Masonry, Modular, Carousel, and Video Gallery blocks. Every block is performance-focused, mobile-friendly, and optimized for real portfolio use cases. FolioBlocks brings powerful visual tools into the native editor so you can work quickly and maintain full creative control.
Included blocks:
* Background Video Block – Add an autoplaying, responsive background video with overlay content on top
* Before & After Block – Compare two images with an interactive slider
* Loupe Block – Highlight fine details with an elegant magnifying zoom effect
* Carousel Gallery Block – Smooth, swipe-friendly horizontal image slider
* Filmstrip Gallery Block – Scroll through large images with thumbnail navigation below
* Grid Gallery Block – Classic evenly-spaced grid layout
* Image Block – Display a single image with lightbox, hover overlay, optional downloads, and WooCommerce linking
* Justified Gallery Block – Professional row-based gallery with balanced heights
* Masonry Gallery Block – Pinterest-style vertical gallery layout
* Modular Gallery Block (Pro Only) – Build custom, magazine-style image layouts
* Video Block – Display a single video with custom thumbnail, lightbox playback, captions, and optional WooCommerce linking
* Video Gallery Block – Showcase YouTube, Vimeo, or self-hosted videos
Gallery Features – All gallery blocks include:
* Fully responsive layouts for desktop, tablet, and mobile
* Built-in Lightbox
* Caption support and accessibility-friendly interactions
* Drag-and-drop image ordering
* 100% native Gutenberg block editing (no shortcodes, no separate gallery manager)
* Block Transforms covert galleires in one click (Grid, Justified, or Masonry and Carousel or Filmstrip)
Advanced Features (Pro) – Unlock advanced tools designed for photography websites, creative portfolios, and WooCommerce-powered shops:
* Block Transforms convert galleries in one click
* Gallery Image Filtering
* WooCommerce Product Integration
* Download Full-Resolution Images
* Randomize Image Order
* Disable Right-Click / Content Protection
* Lazy Load Images for faster performance
* Hover Effects and Image Overlays
* Advanced Gallery Styling Controls (borders, shadows, radius, etc.)
Why FolioBlocks?
FolioBlocks is built for users who want fast, native, block-based galleries without the complexity of third-party gallery builders or shortcode-based plugins. If you want a clean, modern way to display photography, client work, products, portfolios, or case studies—FolioBlocks gives you those tools directly inside the editor.
Source Code
Public repository:
https://github.com/folioblocks/folioblocks
Screenshots
Before & After Comparison block populated with images
Carousel Gallery block populated with images
Grid Gallery block populated with images
Justified Gallery block populated with images
Masonry Gallery block populated with images
Video Gallery block populated with images
What is FolioBlocks?
FolioBlocks is a collection of modern, responsive gallery and media blocks built specifically for the WordPress Block Editor (Gutenberg). You can create image and video galleries with advanced layouts like Grid, Masonry, Justified, Carousel, and more — all directly in the editor.
Does FolioBlocks work with any WordPress theme?
Yes. FolioBlocks is designed to work with all modern WordPress themes. For best results, we recommend using a block theme that supports Full Site Editing.
What’s the difference between the free and Pro versions?
The free version includes all the core blocks with the exception of the Modular Gallery. The Pro version includes the Modular Gallery block and unlocks additional premium features accross all blocks such as Gallery Filtering, WooCommerce integration, Image Downloads, Randomize Image Order, Lightbox Captions, Right-Click Disable, Lazy Load, and more.
Can I use FolioBlocks with page builders like Elementor or Divi?
FolioBlocks is built specifically for the WordPress Block Editor (Gutenberg). It will not work inside Elementor, Divi, or other third-party page builders.
Will FolioBlocks slow down my website?
No. FolioBlocks is optimized for performance and loads only the scripts and styles needed for each block. The Pro version also includes Lazy Load support to further improve loading speed.
Can I upgrade from the free version to Pro?
Yes. You can install the free version from the WordPress plugin directory, and upgrade to Pro at any time. Your galleries will continue to work — you’ll simply unlock unlimited images and additional features.
Do you offer support?
Yes. Free users can post support requests on the WordPress.org plugin forum. Pro users receive priority email support directly from the developer.
Can I use FolioBlocks on client websites?
Absolutely. FolioBlocks is built with agencies and freelancers in mind. The Pro version offers licensing for single sites, 5 sites, or unlimited client projects depending on your plan.
Will my galleries stop working if I deactivate the plugin?
No, the galleries will remain in place on your site. However, the advanced layouts and features are powered by FolioBlocks, so deactivating the plugin will remove those.
ChangeLog
1.2.3
- Fixed a bug that caused undefined variable warning in Grid Gallery
1.2.2
- Added responsive settings to Row Height slider in Justified Gallery Block.
- Updated Lightbox on Image Block to fill more of the viewport when exapnded.
- Increased maximum row height value on Justifed gallery block.
1.2.1
- Added support for videos from Bunny Stream to the Video Block and Video Gallery.
- Moved video parsing logic from block into seperate helper file.
1.2.0
- Public release of Filmstrip Gallery & Background Video Block.
- Public release of Block Transforms.
- Public release of new Custom Color Overlay in all galeries.
- Public release of Overlay Styles on Video Block and Video Gallery.
- Public release of multi-category filtering in all galleries.
- Updated Free Vs Pro Page with new blocks and block features.
- Fixed layout bugs in the Background Video Block.
1.1.8
- Fixed a bug that prevented Play/Pause and Full Screen from being accessed when overlay was enabled on Filmstrip Gallery.
1.1.7
- Prevent Filmstirp Gallery coming into focus when autoplay is enabled in the editor.
- Added support for setting Add To Cart icon behavior when using WooCommerce integration on Video Block & Video Gallery.
- Added Randomize Image Order feature to Filmstrip Gallery.
- Fixed a bug in Add To Cart icon on Video Block and Video Gallery.
- Fixed a bug in Image Block that prevent drop shadow from being applied when used individually.
1.1.6
- Layout related bugs on Background Video Block.
- Fixed a bug on Video Block and Video Gallery Block that threw up warning on the free verion of FolioBlocks.
- Fixed a bug on Video Block that displayed an empty PanelBody.
- Fixed bugs on Carousel, Grid, Justified, Masonry, and Video Gallery blocks that displayed a Notice out of alignment.
1.1.5
- Added support for setting multiple categories per image when filtering in Grid, Justified, and Masonry Galleries.
- Added support for setting multiple categories per video when filtering in Video Gallery.
- Updated to a MediaPlaceholder for initial state on Background Video Block.
- Moved Enable Full-Screen Mode feature on Filmstrip Gallery into premium.js
- Fixed visual layout bugs in Filmstrip Gallery.
- Updated Filmstrip Gallery to set image ID and srcset size.
- Updated Carousel Gallery to use custom CompactTwoColorControl.
1.1.4
- Build initial render.php file for Filmstrip Gallery.
- Added support for Block Transforms for Carousel Gallery and Filmstrip Gallery.
- Filmstrip Gallery block now supports setting image resolution.
- Filmstrip Gallery now supports showing title on hover.
1.1.3
- Added Overlay styles (Default, Blur, & Color) to Video Block & Video Gallery.
- Fixed bug in Color and Fade Overlay that affected image title rendering.
- Merged Title and Play button visibility into one control on Video Block & Video Gallery.
- Replaced Play button icon on Video Block with SVG variant.
- Combined all icon helper files into one file.
1.1.2
- Added keyboard full-screen support (F) for the Video Lightbox.
- Added support for Disable Right Click to Background Video Block.
- Added block transforms on Grid Gallery, Justified Gallery, and Masonry Gallery.
- Updated the Free Vs Pro page to include new blocks and new features.
- Prevent all blocks from transforming into Groups, Columns, or Details blocks.
1.1.1
- Added new Background Video Block.
- Added new Color Overlay option for all photo galeries (Carousel, Grid, Justified, Masonry, & Modular) and Image Block.
1.1.0
- Added style controls to set icon color and background color on Add To Cart and Download icons.
- Added Drop Shadow control to Image Block.
- Added new compact Border color component.
- WooCommerce Add To Cart Links now uses Ajax.
- Images linked with WooCommerce can now select if the Add To Cart button Adds Product to Shopping Cart or leads to Product Page.
- Fixed visual bug in Modular gallery where margin bottom in stacked images created gap between image and the selection outline.
- Changed Gallery Image Styles now all inside of a single filter.
1.0.10
- Bug in Modular Gallery border controls.
- Bug in playback controls on Carousel Gallery Block.
1.0.9
- Fixed bug in Masonry Gallery Image Filtering.
1.0.8
- Fixed bug in Grid Gallery layout logic.
- Fixed bug in Image block when using border-radius.
- Reduced availble border-width in all galleries to a maximum of 15px.
- Reduced available border-radius on all galleries to a maximum of 50px.
- Changed label names on all Gallery blocks to ensure matching language.
- Changed default setting for Image Downloads to “On Hover” to match default in WooCommerce Integration.
1.0.7
- Fixed bug in Grid Gallery that clipped images when set to content width.
1.0.6
- Adds Image Block and Video Block as standalone blocks.
- Updates the organization of controls on all blocks.
- Additional Hover Styles built into Image Block.
- Add controls to access new Hover styles to Carousel, Grid, Justified, Masonery, and Modular galleries.
- Adds Lightbox, WooCommerce, Lazy Load, and Disable Right-click options to Video Block when used individually.
- Adds Resolution, Lightbox, Hover, WooCommerce, Image Download, Lazy Load, Disable Right-Click options to Image Block when used individually.
- Added API Version to migration script in deprecated.js to prevent false warnings in WordPress 6.9.
- Fixed layout issue with Justified Gallery when using Gallery Filtering
- Fixed block previews on Image Block and Video Block
- Fixed escaping issue on Loupe block
- Fixed a layout issue with the final row on Justified Gallery
1.0.5
- New Loupe Block introduced.
- Fixed bug that prevented Disable Right-Click on Carousel Gallery.
- Changed variable prefixes to comply with WordPress standards.
1.0.4
- Changed variable prefixes to comply with WordPress standards
- Fixed escaping issues on dashboard pages
1.0.3
- Improves loading method on premium scripts
- Upgrade page now redirects to pricing page on FolioBlocks website
1.0.2
- Fixed minor bugs in Grid, Justified, and Masonry galleries
1.0.1
- Added is-loading spinner to Carousel, Grid, Justified, and Masonry galleries
- Fixed bug in Carousel gallery that prevented correct height from being set
- Fixed bugs related to FolioBlocks domain name switch
- Tested for WordPress 6.9 compatibility
1.0.0
- Public Release
- Rebuilt the Admin Dashboard
0.9.9
- Modular Gallery Block is now available on Pro only
- Lightbox Caption and Show Title on Hover now Pro only features
0.9.8
- Fixes for WordPress.org compliance
0.9.7
- Updated slugs on all blocks to new name, Portfolio Blocks becomes FolioBlocks
0.9.6
- Updated all blocks to remove premium code from free version
- Updated PB Image Block and PB Video Block to remove premium code
- Rebuilt PB Video Block Lightbox to match PB Image Block
0.9.5
- Changed plugin slug for WordPress.org compliance
- Added deprecated.js to all blocks to help transition beta testers into new slug
0.9.4
- Improved icon adjustment with border & border radius
- Fixed TypeError on all blocks
- Removed title tag from PB Image Block
- Fixed Safari hover blur bug in Carousel Gallery
- Fixed Grid Gallery filtering bug
- Fixed additional WordPress.org compliance issues
0.9.3
- WooCommerce toggle now only appears when WooCommerce is active
- Fixed Carousel icon sizing bug
- Fixed Modular Gallery Add To Cart icon sizing bug
- Fixed PB Image Block Add To Cart icon border bug
0.9.2
- Added WooCommerce integration to PB Video Block
- Added WooCommerce integration to Video Gallery Block
0.9.1
- Replaced front-end icons with PNG files for consistent sizing
- Fixed Grid Gallery layout issue when icons were present
0.9.0
- Added WooCommerce integration to Carousel, Justified, Masonry, and Modular Galleries
0.8.9
- Added WooCommerce integration to Grid Gallery
- Added WooCommerce integration to PB Image Block
0.8.8
- Rebuilt premium filters for consistent method across all blocks
0.8.7
- Fixed bugs introduced in 0.8.6
- Fixed Image Overlay coverage issue
0.8.6
- Improved entrance animations for all galleries
- Fixed Video Block rendering bug when thumbnail missing
0.8.5
0.8.4
- Fixed focus state bug in Carousel Gallery
- Added Lazy Load & Disable Right Click to Video Gallery
- Added Lazy Load & Disable Right Click to Before & After Block
0.8.3
- Added Title & Description in Lightbox to Video Gallery
- Fixed Carousel navigation sync bug
- Disabled Image Gallery Lightbox inside editor
- Improved accessibility of Lightboxes using keyboard navigation
0.8.2
- Added FAQ section to readme.txt
- Updated Carousel Gallery icon
- Added 15 image/video limit to free version galleries
- Updated admin page to show alternate text for premium users
- Fixed Carousel centering issue
- Fixed Carousel vertical orientation bug
0.8.1
- Additional fixes for WordPress Plugin Check
- Fixed premium script loading
0.8.0
- Added required assets for WordPress.org plugin repository
- Additional fixes for WordPress Plugin Check
0.7.9
- Added Lazy Load to all galleries
- Improved Modular Gallery layout logic performance
0.7.8
- All locked free-version features now link to Upgrade page
- Changelog on admin page now auto-pulled from readme.txt
0.7.7
- Added Lazy Load hooks to all galleries
- Freemius bug fixes
0.7.6
0.7.5
0.7.4
- Added Freemius premium feature logic to Video Gallery Block
0.7.3
- Added Freemius premium feature logic to Carousel & Before & After blocks
0.7.2
- Added Freemius premium feature logic to Masonry & Modular galleries
0.7.1
- Added Freemius SDK
- Added Freemius premium feature logic to Grid & Justified Galleries
0.7.0
- Moved Modular Gallery layout logic to parent block for improved performance
- Improved preliminary screens for Modular & Video Gallery Blocks
0.6.9
- Added Before & After comparison block
- Fixed block previews
- Fixed Carousel resizing bug before saving
0.6.8
- Improved stability when injecting thumbnails into List View
0.6.7
- Completed Carousel render.php
- Fixed container-type bug in PB Image Block
0.6.6
- Began building Carousel Gallery Block
0.6.5
- Added custom icons to all blocks
0.6.4
- Fixed download icon in Lightbox across galleries
- Fixed mobile arrow placement in Lightbox
- Adjusted download icon styles
0.6.3
- Organized gallery settings
0.6.2
- Added Right-Click Prevention to Grid, Justified, Masonry, Modular Galleries
0.6.1
- Fixed Masonry border-related layout bug
- Fixed Justified gallery mobile margin bug
0.6.0
- Added Image Download support to all image galleries
- Updated hover behavior: titles shown instead of captions
0.5.5
- Added border & border-radius support to PB Image Block and all galleries
- Moved Grid Gallery layout logic out of PB Image Block
0.5.4
- Tested compatible with WordPress 6.8
- Moved Filter Bar color settings into Styles panel
- Continued scaffolding Modular Gallery and Image Row blocks
0.5.3
- Added responsive column control component
- Fixed Masonry column count bug
0.5.2
- Began license management UI
0.5.1
- Created admin settings page
0.5.0
- Grid, Masonry, Justified, and Video Gallery blocks feature complete
