Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Tags Addon

Do you want to allows visitors to filter the images in your gallery? With the Tags Addon for Envira Gallery, users can do just that! This doc shows you how to display a list of tags above your Envira Gallery using the Tags Addon, which visitors can select to filter the gallery view, displaying only the images assigned to the chosen tag.

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

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

Your first step is to create a new gallery or edit an existing one. You can follow along with our documentation for creating your first gallery.

Navigate to the Tags tab. Click the Enable Tag Filtering?. You can also set up the remaining options there for sorting.

Click the box to Enable Tag Filtering from the Tags tab

Now we’ll need to edit our gallery images in order to schedule them. To do this, click the blue pencil icon on your images to open the Edit Metadata window.

Click the blue pencil icon to edit the gallery images and tag each image

Here you’ll add your tag(s) to each gallery image. You can add multiple tags by separating each tag with a comma.

Once you’ve added all your tags for your image, click the Save Metadata button to save the changes.

You can use the right and left arrows at the top of the Edit Metadata screen to repeat these steps for the remaining gallery images.

Once your done, just click the X icon to close the Edit Metadata window.

Finally, click Publish or Update on your gallery to save the changes.

Alternatively, you can also auto-tag images using the Imagga image tagging service.

In the WordPress admin, navigate to Envira » Settings » Tags tab.

Here you’ll see options to enable, connect to your Imagga account and configure the Imagga: Minimum Confidence percentage.

Check the box for Imagga: Enable Auto Tagging? in this screen to get started.

Enable Auto Tagging on the Envira Settings screen under the Tags tab

Next, create an account at Imagga. They provide a generous free tier to get started. Once you’ve confirmed your account, copy the Authorization Code from your Imagga Dashboard.

Imagga dashboard authorization code.

Return to the WordPress Admin and paste the code into the Imagga: Authorization Code field.

You can also specify a Imagga: Minimum Confidence percentage. If specified, only adds tags to images where Imagga matches or exceeds the above confidence percentage rating. A lower confidence means it is more likely less accurate tags will be included in an image.

The default value is 40%, raise or lower this based on your own specific needs.

Then just click the Save button to save the changes to begin auto-tagging images.

Imagga auto-tagging is not applied to images already present in your galleries. You’d need to manually add tags to any images already in your Enivra gallery.

That’s it! You’ve successfully configured auto-tagging for your galleries!

See the demo!

Using the Albums Addon you can also use Envira Tags Addon for albums too! Check out our tutorial on How to Create a Filterable Album.

A: Absolutely! Just follow along with our tutorial here on How to Bulk Edit Gallery Images to bulk edit your gallery images and add your tags.

A: You can navigate to the Envira Gallery » Tags screen to manage your tags.

You can manage your tags by navigating to the Tags screen from the Envira menu tree.

A: Yes! We have an article on How to Style the Tags List.

A: Yes! Using the Dynamic Addon you can display a tag-based dynamic gallery.

A: Yes! Follow our documentation to learn how to filter by Envira Tags in the WordPress Insert Media View.

A: In order to receive the smooth transition, you must make sure you have checked the Enable Isotope setting from the Configuration tab of the gallery. If Enable Isotope is un-checked, you will notice selecting a tag to filter your gallery will result in a page reload each time you filter the gallery.

Enable Isotope on the column gallery from the Configuration tab for smoother filtering

It’s also possible that you have selected the Automatic layout for the Number of Gallery Columns on the Configuration tab. The smooth transition is only used (currently) in the Column layout (1, 2, 3, 4, 5 or 6 columns).


A: The tags you’ve included in the section for Tags to include for Filtering will be the only tags populating the list.

Tags to include in your filter

A: Please check how you are including your tags. If you are using the Tags to include in Filtering option, this is the order that your tags will appear in:

sort order for tags addon

A: Please check to make sure your Envira Tags and your Envira Categories are not using the same name.

All gallery titles, album titles, Envira Tags and Envira Categories should have unique names. If you notice any issues please edit the names and their slugs or permalinks to make it specifically unique and then go to Settings » Permalinks and click Save to update WordPress that a change was made.

A: Absolutely! On the Tags tab you can also click to Enable EXIF Tag Filtering? as well.

Enable Tag Filtering for EXIF tags on the Tags tab too

A: Absoultely! The Tags tab is also available when creating or editing an Envira Album.


1.7.8 (02-05-2020)

  • Added: Filter to control displayed tags in admin moda: envira_gallery_tags_modal_args
  • Fix: Fixes to admin menu settings that should be hidden in certain scenarios.
  • Fix: Minor typos and PHP warnings resolved.

1.7.7 (12-17-2019)

  • Added: Improved support with Imagga v2.0 API
  • Fix: Better compatibility with Slikk and similar themes.
  • Fix: Resolved filtering in isotope issues.
  • Fix: Dupilcating images and/or tags in some setups resolved.
  • Fix: Tagged Gallery only showing certains tagged images in lightbox. (10-24-2019)

  • Added: Settings to enable/disable tag count.

1.7.6 (10-23-2019)

  • Added: Tag count.
  • Fix: Tweaks and bug fixes related to tag filtering.

1.7.5 (05-20-2019)

  • Fix: Issues related to lightbox not working once tag was triggered.

1.7.4 (01-16-2019)

  • Added: White labeling of the ?envira-tag= parameter is now possible.

1.7.3 (11-07-2018)

  • Fix: Tags and Manufactures menu CSS.

1.7.2 (10-16-2018)

  • Added: Image counts/filter in tags admin screen.

1.7.1 (05-30-2018)

  • Fix: Minor bug fixes.

1.7.0 (04-10-2018)

  • Added: Fancybox3 support.
  • Fix: Minor bug fixes.

1.6.2 (11-07-2017)

  • Fix: Dynamic Compatibility

1.6.1 (10-23-2017)

  • Fixed: Minor bug fixes

1.6.0 (10-18-2017)

  • Fixed: Minor bug fixes

1.5.1 (08-22-2017)

  • Fixed: Tags disappear on Column Layout

1.5.0 (08-08-2017)

  • Fixed: instances where the page reloads
  • Fixed: Active class not being added on all galleries

1.4.9 (07-25-2017)

  • Fix: Minor bug fixes

1.4.8 (04-13-2017)

  • Fix: Minor bug fixes

1.4.7 (03-08-2017)

  • Fix: Tags to include for filtering and manual sort compatibility.

1.4.6 (02-15-2017)

  • Fix: All tags output class
  • Fix: Minor bug fixes

1.4.5 (02-01-2017)

  • Fix: Albums not sorting
  • Fix: Minor bug fixes

1.4.4 (01-19-2017)

  • Fix: Minor bug fixes

1.4.3 (2016-12-08)

  • Fix: Dynamic Compatibility
  • Fix: Minor bug fixes (2016-12-08)

  • Fix: All tag always has active class (2016-11-03)

  • Fix: Various minor bugs. (2016-10-04)

  • Fix: Ensure manual sort saving the changes when altered for albums and galleries. (2016-08-25)

  • Fix: "&" character no longer causes tags to not appear. (2016-07-26)

  • Fix: Minimum Confidence setting now saves properly. (2016-07-01)

  • Fix: Remove debugging code from album output to prevent errors.

1.4.2 (2016-06-30)

  • Fix: Category tags should save properly for albums.
  • Update: Removed redudant category metabox in right sidebar on ablums when tag addon is activated.

1.4.1 (2016-05-12)

  • Added: Option to enable or disable All tag
  • Added: Option to only display images with specified tag on load
  • Added: Option to filter Album Galleries by Category
  • Fix: Ensure image tags are included in Envira Gallery export files

1.4.0 (2016-05-05)

  • Updated: Standardised edit screen titles and descriptions

1.3.9 (2016-04-28)

  • Fix: Output tags within the Envira Gallery container, so they can be better managed by CSS, JS and other Addons, such as Pagination.

1.3.8 (2016-04-21)

  • Updated: Spanish translation

1.3.7 (2016-04-16)

  • Fix: Prevent success / error notices on Settings screen from jumping

1.3.6 (2016-03-31)

  • Added: Documentation and Video Help Links
  • Updated: Moved image editing modal descriptions inline with fields

1.3.5 (2016-03-10)

  • Fix: Scroll to Gallery anchor changed so tags are not sometimes hidden
  • Fix: Get Term by Name and output slug in gallery image class so JS filtering works correctly
  • Updated: Spanish Translations

1.3.4 (2016-03-03)

  • Added: Tags are stored against an image when uploaded from Lightroom (requires Adobe Lightroom; Envira Lightroom Addon 1.0.3+)
  • Fix: Tags displaying slug instead of name
  • Fix: Non-JS tag filtering URLs failed to use slug correctly

1.3.3 (2016-02-25)

  • Added: Sort tag filters option
  • Added: Manually define tag filter display order

1.3.2 (2016-02-18)

  • Added: Option to scroll to gallery when tag clicked

1.3.1 (2016-02-11)

  • Added: Automatically tag images using the Imagga API
  • Added: tags=“*” will output a Gallery comprising of all tagged images
  • Fix: No longer require the tags_id element on shortcodes; require the ID parameter. This standardises shortcode syntax to follow all Envira Addons.
  • Fix: Clear caches on all tag-based galleries on image tag change to ensure all relevant tagged images are displayed (2016-02-08)

  • Fix: envira_tags_get_gallery_by_tags() error

1.3.0 (2016-02-04)

  • Added: Restructured plugin to use classes and singletons per other Envira Addons
  • Added: Filter images in Media Library view by Envira Tag
  • Fix: Renamed ‘Tags’ to ‘Envira Tags’ so it’s easier to distinguish in third party plugins between Post Tags and Envira Tags

1.2.5 (2015-12-31)

  • Added: Support for new Envira Gallery meta editor

1.2.4 (2015-12-23)

  • Updated: Spanish translations

1.2.3 (2015-12-10)

  • Updated: Spanish Translation
  • Fix: Ensure all strings are localized for translation

1.2.2 (2015-11-26)

  • Added: Spanish translation.
  • Fix: Ensure Tags appear alphabetically on front-end output to match backend output when "Tags to include in Filtering" are defined.

1.2.1 (2015-11-06)

  • Fix: Tag filtering works when multiple Galleries embedded on a single Page.

1.2.0 (2015-10-29)

  • Fix: Unexpected end of input JS error when using Albums.

1.1.9 (2015-10-14)

  • Added: Add tags to multiple images (requires Envira Gallery 1.3.7+)

1.1.8 (2015-09-24)

  • Added: Abstracted transient expiration

1.1.7 (2015-07-30)

  • Added: Ability to define tag label

1.1.6 (2015-07-23)

  • Added: Most Popular Tags below Tag Inputs


  • Added: Number of Images Limit support for Dynamic Addon


  • Added: Tags Addon actions when a new image is uploaded or selected for insertion into a Gallery.
  • Fix: Tag filtering by slug when AJAX / JS not used.


  • Added: Better actions and filters on taxonomies for easier documentation


  • Added: Generate galleries with images matching all specified tags or any specified tag(s)


  • Added: Non-Javascript support for filtering a Gallery by Tag


  • Added: Tags Tab in WordPress Admin UI when editing a Gallery
  • Added: CSS for general markup now in main Envira Gallery CSS for better accessibility
  • Added: Support for outputting Envira EXIF Make/Manufacturer tags
  • Added: Generate a dynamic gallery by image tag across all Envira Galleries (requires Envira Dynamic 1.0+)


  • Fixed: Ability to choose which tags appear for the tag filtering


  • Added: Misc tab - ability to choose which tags appear for the tag filtering


  • Fix: Support for Envira Gallery 1.3.0 and higher with Isotope v2


  • Fix: Tag filtering on Envira shortcode re-enabled


  • Full localization support with .pot files.
  • All tags now moved to custom taxonomy for better query support (and eventual support for popular tags and building galleries by tag).


  • Removed leftover logging utility from the addon.


  • Updated to reflect new namespacing for Envira.


  • Fixed bug causing tags not to be saved.


  • Fixed bug that caused tag filtering to always be turned on.


  • Initial release of the addon.