Gallery & Image Block Lightbox


This WordPress Plugin adds a simple & lightweight Lightbox to the standard WordPress Gallery & Image Block. It detects if a post contains a Gallery or Image Block and then loads & initialize baguetteBox.js, a pure JavaScript Lightbox script without any dependencies and a modern minimal look.

There is no lock in effect. It does not add a new Block Editor/Gutenberg Block and relies solo on the standard WordPress Gallery and Image Block. You can deactivate this plugin at any time and your Gallery and Image Blocks will work as they’ve done before. Just without the lightbox.

Just one important thing to remember: You always have to select Link toMedia File for all of your Galleries & Images to work properly. If you choose None or Attachment Page it will not work. But that’s fine if you don’t want the Lightbox for a specific Image or Gallery.


Here are the features of baguetteBox.js:

  • Written in pure JavaScript
  • No dependencies (e.g. jQuery)
  • Image captions support
  • Responsive
  • Supports swipe gestures
  • Around 13 KB, 7 KB gzipped

Works with

  • Gallery Block (Default Block)
  • Image Block (Default Block)
  • Media and Image Block (Default Block)
  • Gallery (Default Classic Editor Gallery)
  • CoBlocks Gallery Collage / Masonry / Offset / Stacked

Don’t forget to select Link to → Media File for all of your Galleries & Images to work properly.


  • Simple, modern and minimalistic Lightbox for your Gallery Block
  • Set Link to to Media File on your Gallery Block


  1. Upload the folder gallery-block-lightbox to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Add a Gallery or Image Block to your Post and set Link toMedia File
  4. Check your Gallery or Image with Lightbox on the front end by clicking on an image


When I click on an image, nothing happens

Check if you used the built in Gallery Block and if Link to is set to Media File in the Block sidebar. On an Image Block choose Add Link at the Toolbar.

Does it work for single images?

Yes! Just set the Link at the Toolbar to Media File

Can I deactivate the Lightbox for a single Image or Gallery?

Set Media File to None or remove the Link.

Is there a way to set the default Link to option to Media File?

Since WordPress 5.6 you can now set the default behavior for Link to. Go to and search for image_default_link_type. Set the value to file and hit save. This will apply to all new Image & Gallery Blocks.

Or you can add the follow snipped (WordPress 5.7+ / PHP 7.4+) to your functions.php:

add_filter('option_image_default_link_type', fn () => 'file');

How can I add my own Block? / Can I change the CSS selector?

You can change the CSS selector to a gallery (or galleries) containing <a> tags used by baguetteBox.js with the baguettebox_selector filter:

apply_filter( 'baguettebox_selector', function($selector) { return $selector . ',.my-gallery'; } )

You can override the full selector by just returing your selector e.g. to show all images in your post in one lightbox (not per Gallery/Image Block):

apply_filter( 'baguettebox_selector', function() { return '.entry-content'; } )


23 de noviembre de 2021
I just wanted to add a lightbox to the standard WordPress Gallery block and was getting frustrated with the first couple of plugins I tried. This one worked right away and with minimum fuss. (Just ensure you set the image to link to the media file.)
22 de noviembre de 2021
Took a while, until I discovered this plugin. That name is not the easiest to remember. But now, I got it: This is truely the simplest and lightest lightbox plugin, one can find. If it would include featured images and set links to media files by default, it would be perfect perfect, from my point of view. Anyway. Check it out!
29 de septiembre de 2021
You rock, the plugin works perfectly! Thanks for your time and effort in making a lightweight lightbox 🙂
24 de septiembre de 2021
Gerçekten tek kelimeyle şapka çıkartılacak hafif, modern, basit, yalın, hızlı bir java sicript lightbox resim göstericisi. PC üzerinde mükemmel çalışıyor. Tek kusuru mobil platformlarda navigasyon tuşları gözükmüyor ileri geri gezinti yapılamıyor. Bu eklenti için çok çok teşekkür ederim.
12 de agosto de 2021
Great plugin! I have noticed that if using a Caption it blocks part of the link which is mostly noticeable on Mobile when the image is smaller. If you want to fix it, just add this CSS: .wp-block-gallery .blocks-gallery-item figcaption { pointer-events: none; }
12 de julio de 2021
perfect: download, activate, works - what more could you want. And lightweight at the same time. Works fantastically with the Gallery Block and Image Block
Leer todas las 39 reseñas

Colaboradores y desarrolladores

«Gallery & Image Block Lightbox» es un software de código abierto. Las siguientes personas han colaborado con este plugin.


«Gallery & Image Block Lightbox» ha sido traducido a 2 idiomas locales. Gracias a los traductores por sus contribuciones.

Traduce «Gallery & Image Block Lightbox» a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios


  • Add two Filter baguettebox_selector for the baguetteBox.js CSS selector and baguettebox_filter for the baguetteBox.js file type RegExp filter


  • Support new Gallery Block format (will be released with WordPress 5.9 in December 2021)


  • Fix Caption for the single Image Block


  • Add Caption Support for the Classic Editor Gallery


  • Fix Regex Filter


  • Add support for file links with query parameter at the end


  • Fix image link filter


  • Add support for .avif, .heif/.heic, .tif


  • Add support for Media and Text Block


  • Add support for CoBlocks Gallery Collage / Masonry / Offset / Stacked


  • Add support for Classic Editor Gallery


  • Add support for .svg images


  • Remove trailing slash from register_script/style


  • Support for the default Image Block


  • Support HTML for the Caption


First release