Wisp Gallery is a filterable gallery block for the block editor. Build an image gallery, a photo gallery or a portfolio of posts and pages that visitors can filter by category, in five layouts. It is built on core blocks and the Interactivity API: 3 KB of JavaScript to start, the rest only when a ga
PricingFree downloadThe WordPress.org download is free. Pro versions, add-ons or external services may cost extra.
CompatibilityRequires WordPress 6.6 and PHP 7.4.
SourceWordPress plugins · Nov 22, 2026
01 / Source details
Aboutthistool.
Wisp Gallery is a filterable gallery block for the block editor. Build an image gallery, a photo gallery or a portfolio of posts and pages that visitors can filter by category, in five layouts. It is built on core blocks and the Interactivity API: 3 KB of JavaScript to start, the rest only when a gallery needs it, and no jQuery or other dependencies.
See it live and try every setting
Three blocks
Filterable Gallery – lays out its content as masonry, justified rows, grid, carousel or accordion, with columns, row height and crop per device (desktop, tablet, mobile). Click an item to open the lightbox, follow its link, open the media file, or nothing.
Gallery Filter – category buttons (or a dropdown) that filter one gallery or every gallery on the page, with counts and a smooth animation. Place it anywhere: above, below or beside the gallery.
Gallery Media Query – images from the Media Library by Gallery Category, inside a gallery. New uploads in those categories show up by themselves.
A gallery holds regular core blocks: Image blocks, and Query Loop blocks (the “Gallery Posts” variation) with Post Featured Image and Post Title. Everything core offers for those blocks keeps working.
Free, and complete
Five layouts: masonry, justified rows, grid, carousel (centered slides, endless loop, autoplay) and accordion.
A native <dialog> lightbox with keyboard, swipe, captions and a counter.
Scroll reveal (rise and fade) and hover zoom, in pure CSS.
Gallery Categories for images, posts and pages. Set them in the gallery (one image or several at once), in the Media Library (column, filter and bulk actions) or in the post sidebar.
Patterns: photo portfolio, travel journal, food menu, team, hero carousel, latest posts carousel and a filterable portfolio.
An archive template for Gallery Categories in block themes.
Command palette: add a filterable gallery, switch all galleries between Edit and Preview, tag selected images.
Abilities API (WordPress 6.9+): AI agents can list categories, find and tag images, and create galleries.
Translated into German, Spanish, French, Portuguese (Brazil), Italian, Japanese and Dutch.
Switching from another gallery plugin
Tools → Wisp Gallery import brings over galleries from Envira Gallery, NextGEN Gallery, Modula and FooGallery : images in their order, alt text, captions, links, layout, columns, spacing, lightbox and tags (as filter categories). Each gallery becomes a draft page. Optional replacement shortcodes keep existing posts working, including the Envira, Modula and FooGallery blocks. Also available as wp wisp-gallery import .
Wisp Gallery Pro
A separate plugin, Wisp Gallery Pro , adds more for the same blocks, with a free 14-day trial. This plugin is complete without it: nothing in it is locked, and it shows no ads; the only pointer to Pro is one link in its row on the Plugins screen.
Videos next to photos: Media Library files, YouTube, Vimeo, TikTok and Instagram.
Load more, with a button or on scroll, and albums (a gallery inside a gallery).
WooCommerce: products with price and add to cart in the lightbox, and the Product Collection block.
Lightbox download and share buttons, camera settings (EXIF), deep links, and lightbox styles and colors.
Filter styles and presets, button sizes, count badges, any taxonomy, and the filter in the URL.
Caption looks and colors, more hover and reveal effects, filter animations, and carousel arrow designs.
A pattern pack of ready-made galleries.
Source code
The JavaScript and CSS in build/ are compiled from the human-readable sources in src/ , which ship with the plugin. To rebuild them: npm install && npm run build (uses @wordpress/scripts).
More from eedee
Gutenslider : a slider block for images, videos and any blocks on top (carousels, hero sliders, fullscreen background sliders).
Product Slider Block for WooCommerce : blocks that show your shop’s products as a slider, a card or a product gallery.
External services
Wisp Gallery loads no remote fonts or scripts, and sends nothing from your site unless an admin opts in.
Freemius (opt-in, and licensing for Wisp Gallery Pro). Wisp Gallery includes the Freemius SDK. After activation, a screen asks once whether you want security and feature updates and news about Wisp Gallery. Nothing is sent unless you click “Allow & Continue”: then your name and email, the site’s address, title and language, and the WordPress, PHP and Wisp Gallery versions are sent to Freemius, and you may get occasional emails about Wisp Gallery. The list of your other plugins and themes is never sent. “Skip” sends nothing and the screen does not come back; “Opt In” and, after opting in, “Opt Out” on the Plugins screen change your choice. If you buy, try or activate Wisp Gallery Pro, your license and the same site details are sent to Freemius to check the license and deliver updates. Terms , Privacy
See it in action
Screenshots & previews.
A filter with counts above a masonry gallery.The carousel layout, one of five: masonry, justified rows, grid, carousel and accordion.The lightbox: a native dialog with keyboard, swipe and caption support.The filter in your theme's button style, with counts.The Filterable Gallery block in the editor, with layout, device and column settings.Gallery Categories in the Media Library: a column, a filter dropdown and bulk assignment.The importer for Envira Gallery, NextGEN Gallery, Modula and FooGallery galleries.
02 / Source details
Gettingstarted.
01In WordPress, go to Plugins → Add New, search for “Wisp Gallery” and click Install, then Activate.
02In the block editor, add a Filterable Gallery block and drop in images, or pick them from the Media Library.
03Give the images Gallery Categories (select them in the gallery and use the toolbar, or use the Media Library).
04Add a Gallery Filter block above the gallery. Done.
To move galleries over from Envira, NextGEN, Modula or FooGallery, open Tools → Wisp Gallery import.
03 / Source details
Frequently asked questions.
Does it work with my theme?
Yes. Wisp Gallery is made of blocks and takes the theme’s colors, fonts and spacing. The filter uses your theme’s own buttons. It works in block themes and classic themes with the block editor.
How is it different from the core Gallery block?
The core Gallery block puts images in rows of columns. Wisp Gallery adds masonry, justified rows, carousel and accordion layouts, a category filter, and a lightbox with captions, swipe and a counter, and a gallery can hold posts and pages as well as images.
Can I build a portfolio from posts, not just an image gallery?
Yes. Put a Query Loop (the “Gallery Posts” variation) in the gallery, or mix images and posts in one gallery. Images, posts and pages share the Gallery Categories, so a portfolio of project pages filters just like a photo gallery.
Is the gallery block fast?
The first gallery on a page loads about 3 KB of JavaScript; the lightbox and filter load only when used. Images are lazy-loaded with the right sizes, and scroll reveal runs in CSS.
Where do I get help?
The documentation is at wispgallery.com/docs . Questions and bug reports go to the support forum here.
FinderPress Media Auditor helps site administrators scan for broken images, missing Media Library files, unreachable media URLs, and other media issues across WordPress content. Use it to audit images, video, audio, PDFs, featured images, and attachment files without sending scan data to an external
The Accepted Payment Methods plugin is a straightforward, lightweight solution that enhances your website by displaying visually appealing icons of the payment methods you accept. This plugin is ideal for a variety of websites, including e-commerce platforms, service-oriented websites, and informati