Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Envira Gallery Lightbox Options

Would you like to learn more about the Envira lightbox options? This tutorial will walk you through each option for your Lightbox settings. Let’s explore below all the options for all of Envira lightbox options.


These options for your lightbox may seem very technical. If you’re unsure about any of the options, you can just leave the default settings that Envira creates for you when you first enable the Lightbox.

First you’ll need to either create a new gallery or edit an existing gallery. If you need any help creating your first gallery, please review our documentation here.

Next, from the Lightbox tab you’ve several options.

These options will change based on the Lightbox Theme you’ve selected for your gallery.

Envira Lightbox Options

Here’s a complete list of all your Lightbox options:

  • Enable Lightbox? – Enables or disables the gallery lightbox.
  • Gallery Lightbox Theme – Sets the theme for the gallery lightbox display. You can see more themes by installing the Gallery Themes Addon.
  • Show Title or Caption? – Caption is the default text, but you can override with title if you wish.
  • Image Size – Define the maximum image size for the Lightbox view. Default will display the original, full size image.
  • Caption Position – Sets the display of the lightbox image’s caption. This won’t show if you’ve selected either of the Base lightbox themes.
  • Enable Gallery Arrows? – Enables or disables the gallery lightbox navigation arrows. This won’t show if you’ve selected either of the Base lightbox themes.
  • Gallery Arrow Position – Sets the position of the gallery lightbox navigation arrows. This won’t show if you’ve selected either of the Base lightbox themes.
  • Enable Gallery Toolbar? – Enables or disables the gallery lightbox toolbar. This won’t show if you’ve selected either of the Base lightbox themes.
  • Display Gallery Title in Toolbar? – Display the gallery title in the lightbox toolbar. This will only show if the Enable Gallery Toolbar? is enabled.
  • Gallery Toolbar Position – Sets the position of the lightbox toolbar. This won’t show if you’ve selected either of the Base lightbox themes.
  • Keep Aspect Ratio? – If enabled, images will always resize based on the original aspect ratio.
  • Loop Gallery Navigation? – Enables or disables infinite navigation cycling of the lightbox gallery.
  • Lightbox Open/close Effect – Type of transition when opening and closing the lightbox.
  • Lightbox Transition Effect – Type of transition between images in the lightbox view.
  • HTML5 Output? – If enabled, uses data-envirabox-gallery instead of rel attributes for W3C HTML5 validation.
  • Enable Lightbox Supersize? – Enables or disables supersize mode for gallery lightbox images. This won’t show if you’ve selected either of the Base lightbox themes.
  • Enable Image Counter? – Enables an image counter for the lightbox images when using the Base (Dark) lightbox theme.
  • Enable Gallery Thumbnails? – Enables or disables the gallery lightbox thumbnails.
  • Use Custom Width/Height – This enables you to enter a custom width and height, overriding Envira’s automatic settings. If you enable this, you’ll have further options to set your width and height.
  • Enable Thumbnail Button? – Enables display of thumbnail toggle button in lightbox. Currently only available with the either Base lightbox theme.

Finally we’ll need to configure your mobile lightbox options.

Navigate to the Mobile tab to set up your lightbox options on mobile devices.

Lightbox Options for your mobile viewing

  • Enable Lightbox? – Enables or disables the gallery lightbox on mobile devices. Disabling also removes ANY links from gallery images.
  • Close Lightbox on Swipe Up? – Enables or disables closing the Lightbox when the user swipes up on mobile devices.
  • Enable Gallery Arrows? – Enables or disables the gallery lightbox navigation arrows on mobile devices. This won’t show if you’ve selected either of the Base lightbox themes.
  • Enable Gallery Toolbar? – Enables or disables the gallery lightbox toolbar on mobile devices. This won’t show if you’ve selected either of the Base lightbox themes.
  • Enable Gallery Thumbnails? – Enables or disables the gallery lightbox thumbnails on mobile devices. If you enable this, you’ll have further options to set your width and height.

Once you’ve configured your Mobile lightbox settings, click Publish on your gallery and you’re all set!

Have a look at some of our Lightbox Demos:

Want to see what else you can do on the Lightbox tab? Check out our tutorial on Using External Links in Envira Gallery.


A: Please edit the gallery and the select the blue pencil icon to edit image. On the Edit Metadata screen, verify you have a URL inside the URL field.

If you want the image to link to itself, just select the Media File button, scroll down to click the Save Metadata and you’re all set.

edit image to make sure there is an URL on the image


A: When you’re linking an image to any URL, please make sure you have enabled the lightbox from the Mobile tab or those links will not be included when the page loads.

Just edit the gallery, go to the Mobile tab and check the box to Enable Lightbox? from the Mobile tab. Click Update on the gallery to save the changes.


A: With either of the Base lightbox themes there is a limit to the caption length. For more information on this, read along with our tutorial.