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 doc shows you how to display a collection of galleries in a single album.

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

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

Navigate to the WordPress Admin » Envira Gallery » Albums screen. Then select the Add New button to create a new album.

To create your first Album select the Add New button.

On the next screen, you will notice the process for creating an album is nearly identical to creating a gallery. Just like when you created your first gallery, go ahead and give your Album a Title.

Give your album a unique and easily identifiable title.

Next, drag and drop a few available galleries into your new album from the Galleries tab.

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

IMPORTANT: Only Published 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, go ahead and configure your album’s settings in the Config tab. Albums include some additional options including displaying a description above/below the album and more!

Album Configuration

  • Number of Album Columns: Determines the number of columns in the gallery. Automatic will attempt to fill each row as much as possible before moving on to the next row.
  • Display Back to Album Link?: If enabled and Lightbox is disabled, when the visitor clicks on a Gallery in this Album, they will see a link at the top of the Gallery to return back to this Album.
  • Enable Lazy Loading?: Enables or disables lazy loading, which helps with performance by loading thumbnails only when they are visible. See our documentation for more information.
  • Back to Album Link Location: Sets where the link is displayed.
  • Back to Album Label: Sets custom text for the Back to Album Link.
  • Lazy Loading Delay: Set a delay when new images are loaded.
  • Align Album?: Choose an alignment for this album. This will add a CSS class to the ‘envira-album-wrap’ div.
  • Album Width: Overrides the default album width of 100%, especially useful if you are defining a left or right alignment for the album.
  • Album Theme: Sets the theme for the gallery display.
  • Display Album Description?: Choose to display a description above or below this album’s galleries.
  • Display Gallery Titles?: Choose to display an image title above or below the gallery image for column layouts. For automatic layouts, the title will appear in the image caption on hover.
  • Display Gallery Captions?: Displays gallery captions. For automatic layouts, the caption will appear in the image caption on hover. For column layouts, this will be below each gallery image.
  • Display Gallery Descriptions?: Allows you to display gallery description. For automatic layouts, the description overrides the image caption.
  • Display Gallery Image Count: Displays the number of images in each gallery below each gallery image. For automatic layouts, the count will be appended to the image caption.
  • Column Gutter Width: Sets the space between the columns (defaults to 10).
  • Margin Below Each Image: Allows you to display gallery description. For automatic layouts, the description overrides the image caption.
  • Sorting: Choose to sort the galleries in a different order than displayed on the Galleries tab.
  • Image Dimensions: You should adjust these dimensions based on the number of columns in your album.
  • Enable Isotope?: If enabled, forces images to exactly match the sizes defined above for Image Dimensions. If disabled, images will be resized to maintain their aspect ratio.
  • Set Dimensions on Images?: Enables or disables the width and height attributes on the img element. Only needs to be enabled if you need to meet Google Pagespeeds requirements.
  • Enable Isotope?: Enables or disables isotope/masonry layout support for the main gallery images.
  • Enable CSS Animations?: Enables CSS animations when loading the main gallery images.
  • Image Opacity: The opacity to display images at when loading the main gallery images using CSS animations (between 1 and 100%).

You can configure how your Album appears in the Config tab.

And that’s it! Simply click Publish or if you are editing an album, click Update to save the changes to 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

Now that you’ve completed your first album, take a look at our Dynamic Addon and its more advanced functionality.

A: Envira Albums requires the Standalone functionality. To enable this simply go to Envira Gallery » Settings » Standalone tab and check the box for Enable Standalone.


Once you enable this option and save, you will be all set to start using Envira Albums!

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 Config 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.


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.