Description
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
Installation
- In WordPress, go to Plugins → Add New, search for “Wisp Gallery” and click Install, then Activate.
- In the block editor, add a Filterable Gallery block and drop in images, or pick them from the Media Library.
- Give the images Gallery Categories (select them in the gallery and use the toolbar, or use the Media Library).
- Add a Gallery Filter block above the gallery. Done.
To move galleries over from Envira, NextGEN, Modula or FooGallery, open Tools → Wisp Gallery import.
FAQ
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.
Screenshots







Changelog
1.3.1
2026-11-13
- The Plugins screen has one link to Wisp Gallery Pro instead of two, and the review link no longer shows stars.
1.3.0
2026-11-07
- After activation, a screen asks once whether you want updates and news about Wisp Gallery; “Skip” sends nothing and it does not come back. It replaces the notice three days after install.
- Links on the Plugins screen to Wisp Gallery Pro and its free 14-day trial.
1.2.2
2026-10-15
- Links in image captions, like a photographer credit, keep their own address. Before, the Lightbox and Media file click behaviors pointed them to the image, and None removed them.
1.2.1
2026-10-15
- Uploading several images at once into a gallery no longer adds some of them twice.
1.2.0
2026-10-12
- Three days after install, a one-time notice asks whether you want news about Wisp Gallery. Nothing is sent unless you click “Yes, keep me posted” (what is sent: see External services in the readme); “No thanks” hides it for good. The review request waits while it shows.
1.1.2
2026-10-12
- Updated a bundled library to the latest version.
1.1.1
2026-10-06
- A “Rate Wisp Gallery” link on the Plugins screen, and after 14 days a review request on the Dashboard, Plugins, Media Library and gallery screens. “Maybe later” waits 30 days; once rated or dismissed it never comes back.
1.1.0
2026-10-05
- Renamed from Gallery Z to Wisp Gallery, with a new logo; the site is now wispgallery.com.
- No third-party SDK or licensing code anymore; the plugin makes no requests to other servers.
- Patterns, imported galleries and the archive template use the plugin’s own filter and caption styles.
1.0.1
2026-09-27
- The plugin now includes the source code of its scripts and styles (src/), with build instructions in the readme.
- Readme: an External services section.
1.0.0
2026-09-27
- Five layouts in one Filterable Gallery block: masonry, justified rows, grid, carousel and accordion, with columns, row height and aspect ratio per device.
- Gallery Filter block: buttons or a dropdown, counts, multi-select; filter changes animate with View Transitions.
- Native
<dialog>lightbox that zooms out of the thumbnail, with swipe, keyboard and captions. - Carousel navigation: arrows on or below the photos. Autoplay on or off.
- Reveal-on-scroll effects without JavaScript (rise and fade).
- Gallery Categories for images, posts and pages; images, post queries and media queries mix in one gallery.
- Importers for Envira Gallery, NextGEN Gallery, Modula and FooGallery, with replacement shortcodes.
- Patterns, a Gallery Categories archive template, commands and Abilities API support.
- Translations: German, Spanish, French, Portuguese (Brazil), Italian, Japanese and Dutch.
