Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Albums Addon

Want to show multiple galleries all in one album? With our Albums Addon for Envira Gallery, you can! This tutorial will walk you through how to use the Albums Addon with step-by-step instructions.

Please follow our instructions on how to install and activate addons.

In this instance, you’ll be activating the Envira Albums Addon.

Once you’ve installed your Albums Addon, you’ll see a message asking you to enable the Standalone feature for Envira.

The Envira Albums Addon requires that Envira Standalone is enabled. Please enable Standalone from the Envira Settings page.

To enable this, navigate to Envira Gallery » Settings » Standalone tab and check the box for Enable Standalone.

Then click Save to save the changes.


When using and changing slug name in WordPress, it’s no uncommon to get 404 messages so if you see this on your site, just go to your WordPress Admin » Settings » Permalinks and click Save to re-save the permalinks to flush out the rewrite rules in WordPress.

Your next step is to navigate to the WordPress Admin » Envira Gallery » Albums screen. Then select the Add New button to create a new album.

Click Albums and then Add New to create a new Envira album

On the next screen, you will notice the process for creating an album is nearly identical to creating a gallery.

Give your album a title. For best practices, it’s best to use a unique name that hasn’t been used for any other galleries, posts or pages.

Next, it’s time to add some galleries to your album from the Galleries tab.

Simply drag and drop the galleries into the space provided.

Your available galleries can be found in the Galleries tab when editing your Album.

IMPORTANT: Only Published and non-private galleries are available to add to your album. If you’re not able to locate a gallery you want to add to your album, confirm that you’ve Published the gallery first.

Once you’ve added a gallery or two to your album, it’s now time to configure your album.

On the Configuration tab you’ll see a list of available options that are very similar to what you see with galleries with only a few exceptions.

All available options will show the name of the option and a brief description of the purpose they serve. If at any time you have any questions about any of these options, feel free to reach out to support and we would be happy to assist!

Configure your albums from the Configuration tab

For each gallery inside the album, only 1 image will show to represent that gallery. This is called a gallery cover image.

Now it’s time to set up any specific mobile options for your album. Click on the Mobile tab and enable any specific mobile options for your Envira album.

Setup your Envira album mobile options from the Mobile tab

Finally, simply click Publish on your album and then view it on the front-end of your site to see the results.

You can add or embed an album on a page in the same way that you added or embedded a gallery on a page. Just click the Add Album button from any post or page.

Add the album to your page

Check out some of our album demos we’ve created for a sample view of the powerful Envira Albums Addon.

Now that you’ve created your first album, check out our tutorial on How To Add Image Counter to Album Lightbox.

A: Select the pencil icon on the top of the gallery thumbnail image to select a specific cover image, edit the cover image, and save the metadata.

To edit the cover image for your gallery or the image metadata, select the pencil icon.

With the Envira Albums 1.6.0, you can now upload or select a cover image and the image doesn’t have to be included in the gallery.

To do this, just edit your album. Then click the blue pencil icon to edit the gallery and upload a new cover image or select one from your media library.

Change gallery cover image

Remember to click Save Metadata when making any changes to this screen so that your changes will be saved.

A: Yes! You can do this by enabling the Lightbox option under the Lightbox tab when editing your Album.

To open your album gallery images in lightbox view immediately, enable Lightbox in the album edit screen.

A: To improve the performance of the edit screen not all available galleries are shown by default. You can use the Search box to locate specific galleries you want to add to your Album.

You can search your galleries from the album edit screen to find the ones you want to add.

A: Check that you’re viewing the album through it’s Standalone URL. This link will not appear if you’re viewing the album embedded in a page or post.

A: Yes!  Just follow these steps:

    1. Make sure that from the Lightbox tab, the lightbox is disabled (not checked)
    2. Click the blue pencil icon on the gallery image
      edit the gallery
    3. A pop up window will appear.  Simply enable the Open URL in New Window? by selecting the box beside this option.
    4. Finally, click Save Metadata to update your settings
      open in new window save metadata
This option will only be considered when the Enable Lightbox checkbox from the Lightbox Tab in the first step is disabled for the album.

A: Check if you have the Number of Album Columns set to Automatic in the dropdown from the Configuration tab.

Select the Number of Album Columns

If you are displaying the gallery descriptions, when using the Automatic Justified Layout for albums with the Display Gallery Descriptions? enabled, this will override all other settings to show the gallery caption, the gallery title or the gallery count.

gallery descriptions for my Envira albums

A: Due to the way that the Featured Content Addon allows images to be pulled into a gallery, Featured Content galleries are not compatible with the Albums Addon and will not display any images.

A: Absolutely! Just edit the gallery inside the album by clicking the blue pencil icon and check the box to Make Gallery Title Linkable? and then click the green Save Metadata button to save the changes.

Check the box to make the gallery title linkable in the album

A: Unfortunately at this time Woocommerce Addon and the Albums Addon won’t work together. To add Woocommerce galleries to your album, just uncheck the Enable Lightbox? on the album so that when a user clicks the gallery cover image, they’ll be redirected to the gallery’s standalone tab.

Changelog (02-11-2020)

  • Fix: Resolved minor PHP errors. (02-06-2020)

  • Fix: Resolved caching issue that prevented some albums from showing properly. Clearing transients or letting transients expire after applying this update is recommended.

1.7.5 (02-05-2020)

  • Added: Provided filter to disable links in albums: envira_albums_output_gallery_href
  • Fix: Resolved minor PHP errors.

1.7.4 (12-17-2019)

  • Fix: Album cover images cropped issues resolved.
  • Fix: Resolved minor PHP errors. (10-25-2019)

  • Fix: CSS Adjustments.
  • Fix: Breadcrumb setting issue resolved.

1.7.3 (10-23-2019)

  • Added: Option to enable/disable breadcrumbs on mobile.
  • Fix: Random sorting issues resolved.
  • Fix: Various minor bug fixes.

1.7.2 (08-20-2019)

  • Fix: Update terms and wording on WordPress menu page.
  • Fix: Issue involved "Back to Album" link not appearing consistantly in certain scenarios resolved.

1.7.1 (07-09-2019)

  • Fix: Various minor bug fixes.

1.7.0 (06-04-2019)

  • Added: Intergrated the Envira Breadcrumb plugin.
  • Fix: If Pagination is enabled, Albums were not sorting by Published Date.
  • Fix: Resolved issue with saving custom CSS for albums.

1.6.9 (02-20-2019)

  • Fix: Issue with automatic layout and showing total images.

1.6.8 (02-20-2019)

  • Fix: Conflict with lightbox and CSS addon resolved.
  • Fix: Various minor bug fixes.

1.6.7 (01-16-2019)

  • Fix: Dynamic albums and random sorting issues resolved.
  • Fix: Issue with cover album image and/or settings reset in some setups resolved.

1.6.6 (10-31-2018)

  • Fix: Gallery titles show on hover with automatic layout.
  • Fix: Improved support for standalone albums using unique album slugs. (10-18-2018)

  • Fix: Various minor bug fixes

1.6.5 (10-16-2018)

  • Enhancement: Allow search by single or multiple post IDs for albums in album admin list
  • Enhancement: New "Make Gallery Titles Linkable" option for galleries.
  • Added: Adjustment of margins and padding for non-supersized Lightbox images
  • Fix: Show title, even when link is not enabled
  • Fix: Better showing of album covers in latest Chrome browser.
  • Fix: Tweaked admin UI and CSS on mobile and narrow width devices.
  • Fix: Various minor bug fixes

1.6.4 (08-22-2018)

  • Enhancement: Added support for featured images.
  • Enhancement: French translations updated.
  • Added: Filter for lightbox "idle time".
  • Fix: Minor bug fixes.

1.6.3 (05-30-2018)

  • Fix: Standalone template not saving
  • Fix: Displaying Albums title instead of galleries
  • Fix: Minor bug fixes

1.6.2 (05-01-2018)

  • Fix: Improvements in lighbox displays, including thumbnails, in certain scenarios.
  • Fix: Fullscreen on open works with Fullscreen Addon.
  • Fix: Improved display when no isotope is used
  • Fix: Gallery titles now show properly on dynamic albums
  • Fix: Improved protection w/ Protection Addon
  • Fix: Conflict resolved with EventOn
  • Fix: Album widget now shows in widget screen
  • Fix: Album now properly shows title/caption in previous cases where it was not
  • Fix: Better album sorting with "published date" option
  • Fix: Album caption position on legacy themes now being honored
  • Fix: Minor bug fixes.
  • Updated: Removed unneeded filename and url from sorting options
  • Updated: Removed mouseshweel and keyboard navigation options, now on by default

1.6.1 (04-23-2018)

  • Fixed: Resolved Error Upon Saving Album Data

1.6.0 (04-10-2018)

  • Added: Fancybox3 support
  • Fix: Performance Issues with large number of galleries and lightbox
  • Fix: Minor bug fixes.

1.5.2 (11-07-2017)

  • Fix: Flush permalink when activating
  • Fix: Language characters in titles
  • Fix: Ajax pagination compatibility
  • Fix: Minor bug fixes.

1.5.1 (10-23-2017)

  • Fix: Minor bug fixes

1.5.0 (10-18-2017)

  • Added: Fragment Caching - Album output is now cached utilizing fragment caching
  • Fix: Back to albums not working on Pagination
  • Fix: Minor bug fixes

1.4.5 (08-22-2017)

  • Fixed: Jetpack conflict with Image Count.

1.4.4 (08-08-2017)

  • Fixed: Jetpack conflict with Image Count.

1.4.3 (07-25-2017)

  • Fix: Title toolbar showing html characters.
  • Fix: Minor bug fixes. (06-27-2017)

  • Added: Album CPT page now supports authors.
  • Fix: Add Album button for RTL displays.
  • Fix: PHP errors with Featured Content addon resolved. (05-24-2017)

  • Fix: Output Styling for some theme
  • Fix: Minor bug fixes (05-17-2017)

  • Fix: JS Error on output

1.4.2 (05-16-2017)

  • Fix: Minor Bug Fixes

1.4.1 (04-13-2017)

  • Fix: Gallery Description
  • Fix: Image Count in Automatic
  • Fix: Back to Album displaying incorrectly
  • Fix: Minor Bug Fixes

1.4.0 (03-30-2017)

  • Added: Lazy Load.
  • Fix: Minor bug fixes.

1.3.7 (03-08-2017)

  • Fix: CSS reset when using WYSIWYG.

1.3.6 (02-15-2017)

  • Minor bug fixes.

1.3.5 (02-01-2017)

  • Minor bug fixes.

1.3.4 (01-19-2017)

  • Fix: Tags Compatibility.
  • Fix: Gallery Titles not displaying.
  • Minor bug fixes.

1.3.3 (2017-01-10)

  • Fix: Automatic layout displays titles.
  • Fix: UI for galleries without titles.
  • Fix : Admin search submitting form.
  • PHP optimizations to improve performance.
  • Minor bug fixes. (2016-12-16)

  • Fix: Various minor bug fixes

1.3.2 (2016-12-08)

  • Added: Template Selection
  • Added: Enable/disable lightbox for specific galleries
  • Added: Theme selection option
  • Added: Automatic Layout settings
  • Fix: Cover images are reloaded after saving new image
  • Fix: Cases where js errors were outputted
  • Fix: Galleries with HTML entities in captions breaking layout
  • Fix: Php notices
  • Fix: Automatic lay loading the wrong image size
  • Fix: Options showing when dark and light theme are enabled
  • Fix: Base Dark theme not properly loading
  • Fix: Display Play Icon over Gallery Image not saving (2016-11-07)

  • Fix: Issues with pagination.
  • Fix: Various minor bug fixes

1.3.1 (2016-11-03)

  • Fix: Conflicts with some themes and plugins

1.3.1 (2016-11-03)

  • Added: Option to display titles above or below gallery
  • Added: Option to align album
  • Added: Option to add widths
  • Fix: Changing Permalink breaks albums
  • Albums cases where switching to automatic layout breaks albums (2016-10-06)

  • Fix: Invalid path to gallery themes stylesheets.
  • Fix: Galleries displaying in album even if they had been deleted or trashed. (2016-09-01)

  • Updated: Description for displaying gallery title in settings. (2016-08-25)

  • Added: Galleries now have the option to open in new browser windows.
  • Fix: Showing visiblity for galleries in edit screen.
  • Updated: Spanish translations (2016-07-26)

  • Fix: Dynamic Album shortcode was not working in certain circumstances, now improved. (2016-05-31)

  • Fix: Lightbox toolbar and thumbnail layout fixes.
  • Fix: Ensure that the same transition effects that exist in galleries can be set / applied to albums. (2016-05-19)

  • Fix: Prevent potential collisions with third party Plugins and Themes using different versions of the imagesLoaded library
  • Fix: Prevent JS errors when Albums are loaded by slug (2016-05-12)

  • Added: Conditionally show fields when creating/editing an Album
  • Fix: Compatibility with Pagination Addon when using AJAX (2016-05-05)

  • Updated: Standardised edit screen titles and descriptions
  • Updated: Spanish translations (2016-04-28)

  • Fix: Improved the layout of options on the Mobile tab, so it’s clear which relate to the Album and Lightbox (2016-04-21)

  • Added: Mobile: Option to define number of album columns.
  • Added: External Gallery Types (e.g. Instagram) can now have a cover image chosen (requires Instagram Addon 1.0.6+)
  • Fix: Search Available Galleries
  • Updated: Spanish translation

1.3.0 (2016-04-16)

  • Added: New UI
  • Fix: Warning when outputting a dynamic Album. (2016-03-17)

  • Fix: Apply content filters (paragraphs, smileys, oEmbeds etc) to Gallery Description
  • Fix: Album Add/Edit: List Available Galleries by published date (2016-03-10)

  • Added: Customize Back to Album Label
  • Fix: Return instead of continue for PHP7 compat when outputting Galleries in Album Edit screen
  • Fix: Honor Thumbnail Dimension settings for Galleries within an Album (2016-03-03)

  • Added: generate_album_item_markup() function for better album loading (also Pagination AJAX loading compatibility)
  • Fix: Column gutter applied equally to left and right of each gallery (2016-02-25)

  • Added: Option to sort Galleries in Album by Publish Date
  • Updated: Spanish Translations (2016-02-18)

  • Fix: Removed unnecessary output on Album Import (2016-02-04)

  • Fix: Don’t enqueue media scripts on Albums WP_List_Table
  • Fix: Don’t output Default Gallery in Available Galleries selection (2016-01-28)

  • Added: Filter to Insert Albums button (envira_albums_media_button) (2016-01-21)

  • Added: Import Albums
  • Added: Export Albums
  • Fix: Removed PHP warning if an Album contains Featured Content or Instagram galleries but their respective Addons are disabled.
  • Fix: Mobile Dimensions duplicated on Config and Mobile tabs; dimensions are not just on the Mobile tab. (2016-01-14)

  • Added: Sorting option for Galleries
  • Fix: More efficient way of getting a gallery title if none is specified for the Gallery within an Album (2016-01-07)

  • Added: Featured Content Galleries can be searches and added to an Album.
  • Added: Featured Content Galleries can appear in an Albums lightbox view.
  • Added: Instagram Galleries can be searches and added to an Album.
  • Added: Instagram Galleries can appear in an Albums lightbox view. (2015-12-17)

  • Fix: Album slug would not save when changed (2015-12-10)

  • Added: Spanish Translation
  • Fix: Albums in RSS Feed

1.2.4 (2015-12-03)

  • Added: Captions on Galleries with HTML support
  • Added: Media Uploader JS, otherwise Yoast 3.0.4 breaks (note: we recommend 2.3.x until the well documented, ongoing issues with Yoast 3.x are resolved). Reported issue at https://github.com/Yoast/wordpress-seo/issues/3498 (2015-11-26)

  • Fix: Lightbox Galleries within an Album honour their Lightbox Image Size setting (2015-11-19)

  • Fix: Lightbox Arrow Position not working when set to Outside (2015-11-12)

  • Fix: foreach() warnings on Widget when no Albums created (2015-10-29)

  • Fix: Typo in edit_others_envira_albums capability, preventing some Administrators editing Albums belonging to lesser roles. (2015-10-15)

  • Fix: Added in all required capabilities; removed map_meta_cap.

1.2.3 (2015-10-14)

  • Added: Custom Capabilities for Albums (publish_envira_album, delete_envira_album etc).

1.2.2 (2015-10-01)

  • Fix: Better checking that an Album has one or more gallery IDs assigned to it

1.2.1 (2015-09-24)

  • Added: Abstracted transient expiration

1.2.0 (2015-09-17)

  • Added: Mobile tab options per Galleries (mobile image, dimensions, lightbox, touchwipe)

1.1.5 (2015-09-10)

  • Fix: Prevent double cropping of album cover images; removed cover image URL field until better implementation can be provided.

1.1.4 (2015-09-09)

  • Fix: Gallery thumbnail images blank in admin and frontend after saving an Album
  • Fix: Display captions on gallery images when gallery viewed in Lightbox

1.1.3 (2015-09-03)

  • Added: Cover Image URL field setting for each gallery in an album, so third party / external images can be specified

1.1.2 (2015-08-21)

  • Fix: Call to undefined function load_gallery_theme().

1.1.1 (2015-08-20)

  • Added: Lightbox - Gallery Lightbox Theme, Arrow Position, Title in Toolbar, Toolbar Position and HTML5 Output options to match Gallery Lightbox settings. (2015-08-13)

  • Fix: WordPress 4.3 compatibility for Widget
  • Fix: Publish / update messages when saving an Album now display better context, and don’t show View Post link on Dynamic Album (2015-08-03)

  • Fix: Unexpected end of input errors on some albums (2015-07-30)

  • Added: data- attributes to Lightbox image, per Gallery. (2015-07-16)

  • Fix: Exclude Default and Dynamic Albums when querying get_albums()

  • Added: envira_albums_metabox_scripts action for Addons to better selectively load JS

  • Fix: Lightbox on Albums now works where Gallery Images contain single quotes

  • Fix: Support for large number of Galleries when creating/editing an Album
  • Fix: Multiline Gallery captions breaking Album display

  • Fix: Exclude Dynamic Gallery from list of available Galleries
  • Fix: Conditional Fields in UI

  • Added: get_lightbox_template with filter override for Lightbox HTML markup
  • Added: Back to Album option - when a visitor clicks a Gallery from an Album (not in lightbox mode), a Back to Album link can be displayed at the top of the Gallery
  • Fix: Galleries are removed from Albums when deleted in Envira Gallery (requires Envira Gallery


  • Fix: Galleries not saving in some Albums


  • Added: Set Image Dimensions option for Google PageSpeed
  • Added: Code changes to support upcoming Envira Dynamic Addon


  • Added: Search Galleries to add to Album
  • Added: Multi-select available Galleries to add to Album
  • Added: Option to display gallery title in Lightbox Toolbar.
  • Fix: get_config_defaults() to use own common class for envira_albums_defaults filter to work


  • Added: envira_album_metabox_styles action on Envira_Albums_Metaboxes::meta_box_styles()
  • Added: Touchswipe support for Lightbox
  • Added: Quick Edit Support
  • Fix: Album Gallery Lightbox Captions not displaying


  • Fix: Undefined index errors when WP_DEBUG enabled on saving Album.
  • 1.0.5

    • Added: Enable / Disable Isotope + CSS Animations
    • Added: Mobile detection now performed server side using envira_mobile_detect()->isMobile(), removed unused JS mobile detection code
    • Fix: Upgraded to Isotope v2.1.0
    • Fix: Added imagesLoaded so Isotope only loads when images are ready for masonry layout (fixes several IE issues)
    • Fix: Always force image size dimensions to be honoured, making cropping optional, so that images are always optimised and the user can choose whether to crop those images to a forced size or aspect ratio
    • Fix: Load images via shortcode, not JS, as they are now optimised due to required image size constraints, performance is not affected. Also fixes slow JS rendering engines for Isotope e.g. IE9


    • Fix: Revert to Gallery Title if none specified
    • Fix: Amend minify() function to support http:// in JS vars and not strip it


    • Added: Galleries in albums can be opened directly into the lightbox.


    • Fix: Deleting albums causing PHP notice.
    • Fix: Drag and drop area not expanding as new galleries are added.


    • Fixed fatal error with albums widget.


    • Initial release of the addon.