Directory / plugin

Wisp Gallery

v1.2.2 · by eedee

Filterable galleries for the block editor: masonry, justified rows, grid, carousel and accordion, with a filter block, lightbox and scroll reveal.

About this plugin

Wisp Gallery turns photos, posts and pages into galleries visitors can filter by category, in five layouts, right in the block editor. 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. This plugin is complete without it: nothing in it is locked, and it shows no ads or notices.

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

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 in anonymous mode: there is no opt-in screen, and nothing is sent until an admin says yes. Three days after install, a notice asks once whether you want news about Wisp Gallery. Only if you click “Yes, keep me posted”, 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. “No thanks” hides the notice for good; after opting in, “Opt Out” on the Plugins screen stops it. If you buy 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

Plugin tags