Wisp Gallery

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 makes no requests to other servers: no tracking, no remote fonts or scripts, and nothing is sent anywhere from your site.