Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Albums Addon

Want to show multiple galleries all in one album? You can! Envira Albums Addon allow you to gather your galleries into collections, called albums, to display in a more organized fashion.

This helps you create more comprehensive photo collections that readers can look through without having to navigate through several individual galleries. That’s a great way to make sure your readers see exactly what they want. 

Through the Albums Addon, you can also drag and drop galleries into album collections and configure those albums much like a gallery. 

Here, we’ll walk through how to install and activate the Albums Addon, create a new album of your galleries, and some issues you might run into with the Albums Addon.

You can install the Albums Addon exactly the same way as you would any other addon.

First, click on Envira Gallery » Addons, then find the Albums Addon card. Click the Install button, followed by the Activate button. When the slider is green, that means the addon is active:

Once you’ve activated the addon, you may see a message that states you need to enable Standalone features.

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

To do this, click on Envira Gallery » Settings, then click the Standalone tab. Finally, click the Enable Standalone checkbox and Save your changes:

When using and changing slug name in WordPress, it’s not uncommon to receive 404 messages. If you see this on your site, just go to your WordPress Admin » Settings » Permalinks and click Save to re-save the permalinks. This flushes out the rewrite rules in WordPress.

For more information, follow our instructions on how to install and activate addons.

Once you’ve installed the Albums Addon, you can start creating albums. Go to your WordPress Admin, then click Envira Gallery » Albums to pull up the albums page. Select Add New to create your new album:

Next, give your album a title in the Add title text box. For best practices, it’s best to use a unique name that hasn’t been used for any other galleries, posts or pages:

Scroll down to the Available Galleries card. Here, you should see a list of all the galleries that you have created in Envira Gallery. If you haven’t created any galleries yet, our guide to creating your first Envira Gallery can help.

This is where you can add galleries to this album. Envira Gallery provides an easy-to-use drag and drop interface. Simply click and drag the gallery from the Available Galleries card to the Drag and Drop Galleries Here space:


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 your selected galleries to the album, click on the Publish button. You can also preview the album with the Preview button:

preview and save envira gallery

Much like other Envira galleries, you can insert this album into pages or posts using the shortcode provided:

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

Once you’ve added a gallery or two to your album, it’s now time to configure your album. Configuring your album allows you to control several options regarding how the album works and displays. 

Scroll down to the Configuration tab to pull up the general album configuration settings. 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:

configuration envira gallery albums addon

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

These options are much the same as gallery options:

  • Number of Album Columns lets you set how many columns the gallery will use to display images.
  • Display back to Album Link? checkbox, when selected, displays a link to users that takes them back to the album. By default, when a user clicks a gallery in an album, they go to that gallery.
  • Enable Lazy Loading gives you the option to load images as the reader scrolls down the page. This helps optimize your pages for speed. You can also set the delay in milliseconds in the Lazy Loading Delay section.
  • Several alignment and adjustment options include:
    • Album Alignment
    • Sorting Options based on date, title, description, or alt text
    • Album Width as a percentage of the display area
    • Album Title, Caption, and Description Displays

You can also enable Lightbox when a user clicks on an image by clicking the Lightbox tab, followed by the Enable Lightbox? Checkbox:

Finally, you can set your gallery to display on mobile devices. Click on the Mobile tab, and then check the Create Mobile Album Images? Checkbox:


You can also set various mobile settings here:

  • Mobile Dimensions lets you adjust how images show up in mobile browsers
  • Enable Breadcrumbs turns on breadcrumb navigation
  • Gallery Thumbnail Width and Height let you adjust mobile thumbnails (in pixels)
  • Enable Lightbox turns on Lightbox functionality for mobile users
  • Enable Gallery Thumbnails lets you use Lightbox thumbnails in mobile browsers

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 New Block button from any post or page, then select a Code block, and paste your album shortcode.

If you’re not using WordPress’ new Gutenberg Editor, you can select the Add Album from the top of the Add New Page box to insert your Envira Gallery Album.

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: Simply click the blue pencil icon at the top of the gallery thumbnail image, then click a new image in the gallery list. Select Save Metadata to save your choice:

With Envira Albums 1.6.0 and higher, you can upload or select a cover image that isn’t included in the gallery itself.

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.


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.

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.


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

A: Yes! First, turn off the Lightbox function for the album in the Lightbox tab. Then, click the blue pencil on the gallery you want to modify. On the metadata screen, click the Open URL in new window checkbox:



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: Sometimes, the album layout can limit the information displayed in the album. Check if you have the Number of Album Columns set to Automatic in the dropdown from the Configuration tab.

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.


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. Because these Addons are incompatible, you’ll have to disable the Albums Addon to use the Featured Content Addon, and vice versa. 

A: Absolutely! You’ll have to edit individual galleries to do this. Just edit the gallery inside the album by clicking the blue pencil icon and check the box to Make Gallery Title Linkable? Then, click the green Save Metadata button to save the changes.

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

A: Yes, to an extent. WooCommerce works specifically with the Albums Addon’s lightbox. To enable WooCommerce in your album’s lightbox modal, just check the Enable WooCommerce? option in the album’s WooCommerce tab, and be sure the album’s lightbox is enabled in the Lightbox tab, as well.


1.7.9 (05-11-2023)

  • Fix: PHP 8.2 support. (03-23-2022)

  • Fix: Resolve issue with Cornerstone Builder.
  • Fix: Resolve issue with encoding issue with caption links. (05-26-2021)

  • Fix: Update album gallery titles when galleries are updated.
  • Fix: Resolved fatal PHP errors under some certain conditions. (05-26-2021)

  • Added: lightbox thumbnail toggle to settings.
  • Fix: Improved display of "Back To Album" on pages of paginated galleries in certain situations.
  • Fix: Removed Display Gallery Titles option from album config when automatic layout is selected.
  • Fix: Resolved some minor PHP warnings. (04-28-2021)

  • Fix: Enhancement: Remove Automatic reference inside of "Number of Album/Gallery Columns" setting.
  • Fix: Resolved some minor PHP warnings. (04-07-2021)

  • Fix: Resolved some santitizing issues with lightboxes. (03-24-2021)

  • Fix: Resolved PHP error upon activation (with PHP 8). (03-11-2021)

  • Fix: Resolved minor PHP errors and removed testing code.

1.7.8 (03-10-2021)

  • Added: Added option to adjust lightbox size.
  • Added: Layout options to match gallery layout options.
  • Fix: Resolved minor PHP errors.

1.7.7 (12-02-2020)

  • Fix: Resolved a "unexpected expression" JS error.
  • Fix: Resolved issue with WooCommerce Envira Addon.
  • Fix: Resolved minor PHP errors.

1.7.6 (11-05-2020)

  • Fix: Resolve issue involving showing captions and descriptions under galleries in some cases.
  • Fix: Add missing automatic layout.
  • Fix: Improve album export/import (export galleries first). (09-30-2020)

  • Fix: Improve album import process (galleries to be uploaded before album). (09-21-2020)

  • Fix: Restore Automatic option. (09-16-2020)

  • Fix: Resolving issue with breadcrumbs and cache in certain situations.
  • Fix: Resolved minor PHP errors. (05-27-2020)

  • Fix: Resolving issue with breadcrumbs and cache in certain situations. (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.