Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Social Addon

The Social Addon for Envira Gallery will allow you to easily share your gallery and lightbox images to some of the most popular social networks. We’ll walk you through how to set up the Social Addon for your Envira galleries.



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

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

Configure the Social Addon’s Settings

Before we begin, there are a few things that need to be set up for Twitter and Facebook first.

Step 1 – Facebook

To set up Facebook sharing you’ll need to complete our guide to to create and add your Facebook Application ID to the Social Settings tab.

Step 2 – Twitter

To set up Twitter sharing, just add your Twitter username to the Twitter Username field using the @ symbol and click Save.

Enter your Facebook App ID and Twitter handle here on the Social tab under Envira Gallery Settings

Once the Facebook Application ID and the Twitter Username have been added, it’s time to enable the social sharing on our gallery.


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.

Next, navigate to the Social tab and click the box to Display Social Sharing Buttons? then select the rest of your options for the gallery.

You’ll also notice you have options specific to your Social Lightbox Settings as well as Advanced Settings on this tab.

Configure your social sharing settings for your gallery and lightbox

In your next step, navigate to the Mobile tab, here you can also choose to turn on or off certain social networks (or all) for your mobile viewers on the gallery and lightbox view.

Enable Envira Social Addon for mobile devices

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

See the demo!

And that’s it, you can now share your gallery and album images to the social networks you’ve selected above using Envira’s Social Addon.


Q: Can I enable an Instagram share button with the Social Addon?

A: At this time, Envira doesn’t have the permissions from Instagram for this type of sharing.

Q: Why aren’t my Summary Cards loading in the Tweet when I try to share on Twitter?

A: Check that your site’s robots.txt file isn’t blocking Twitterbot from crawling any directories that contain Envira galleries and ablums.

If you haven’t done any custom edits to the robots.txt file be sure that the Search Engine Visibility setting in your WordPress installation is disabled in the WordPress Admin » Settings » Reading page.

Disable the Search Engine Visibility option to allow search spiders to access your site.

For more information see Twitter’s documentation on crawling.

To validate your Twitter link, first copy the share URL of the image from the Twitter share popup window as shown below:

Once you’ve copied the share URL, go to https://cards-dev.twitter.com/validator and paste it into the Card URL field. Select the Preview Card button to validate the URL and check for any errors.

Even if you are not planning on using Twitter, this tool is a good tool to use for all testing. If your site times out in this test for any reason, this can affect the other social network sharing and this tool will help you find the timeout error more quickly than Facebook debugging can.

Q: Why are my images not showing in the share window when I’m sharing on Google+?

A: Google+ requires that images meet specific standards to be included in the share. Per Google’s documentation:

The image being shared must be sized as follows:

  • must be at least 400px wide.
  • must have an aspect ratio no wider than 5:2 (width:height).

An image meeting the above requirements is always rendered with a width of 506, 426, or 346 pixels, depending on the width of the user’s viewport.

For example, an image with dimensions of 600 x 250px (width:height) qualifies because its aspect ratio of 5:2.1 is narrower than 5:2, but Google scales it down to 506 x 211px, 426 x178px, or 346 x 144px. Google scales down an image of 600 x 300px (5:2.5) to 506 x 253px, 426 x 213px, or 346 x 173px.

Google scales and crops images as follows:

  • images with an aspect ratio taller than 5:3 are scaled to 506px width, and then cropped vertically to 303px height. For example, an image of 600 x 1000px is scaled to 506 pixels wide, maintaining its aspect ratio. It is then cropped at the top and bottom to 506 x 303px (5:3), using an algorithm to keep the most interesting part of the image.
  • images with an aspect ratio between 5:2 and 5:3 are not cropped, but are scaled.
  • images wider than 5:2 disqualify the content from this rendering treatment.
  • depending on the user’s browser viewport width, images may finally be scaled to 426px or 346px wide, maintaining the aspect ratio post-crop.

Be sure the images in your gallery meet Google’s image requirements for sharing.

Q: Some of the options aren’t showing on the Lightbox tab?

A: Some options like choosing to display the social icons outside of the lightbox, or to choose the orientation of icons, are available only with specific lightbox themes. If you’re using either the Base Dark or Base Light lightbox themes neither of these options are available to be configured.

Q: I’m not seeing the Advanced Settings?

A: Be sure you have the latest version of the Social Addon installed on your site. Earlier versions of the addon did not contain the Advanced Settings.

Q: The Pin All isn’t working?

A: When using Pin All and sharing images from the lightbox view, only the current image will be shared. The Pin All functions only when sharing outside of lightbox view.

Q: Why is Facebook is sharing the wrong image?

A: Please check with your hosting company that they are not blocking any meta tags in your sites header.php. If Facebook can’t find the correct tags for the image to share it will share the first image it comes to on the page after it loads.

Q: Would I be able to use more than one tag when using Envira Tags?

A: Facebook’s API has placed this limitation on the amount of tags for Facebook sharing and will only accept one tag to be shared. When setting the Facebook Tag to Envira Tags using the Tags Addon, the first tag set in the Tags tab will be used.

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

A: The message you see there is giving you a head’s up that Google + is retiring the social network.

Google + retiring

Please read their article for further explanation.

A: The WhatsApp social sharing is only available on Mobile devices so the option to use this network will only show on the Mobile tab of the gallery.

A: WhatsApp currently uses the “Optional Text” from Facebook if you Facebook sharing turned on and populated the “Optional Text” field. In a future update we plan on giving WhatsApp a dedicated “Optional Text” field.


1.6.7 (05-11-2023)

  • Fix: PHP 8.2 support. (11-17-2021)

  • Fix: Minor bug fixes and text adjustments in settings tab.

1.6.6 (05-26-2021)

  • Fix: Resolved additional issues with multiple social icons in lightboxes.
  • Fix: Updated Facebook logo.
  • Fix: Remove foreign characters from email sharing on albums. (04-07-2021)

  • Fix: Resolved additional issues with multiple social icons in lightboxes. (03-30-2021)

  • Fix: Resolved issue with multiple social icons in lightboxes.

1.6.5 (03-10-2021)

  • Fix: Updated Facebook SDK.

1.6.4 (11-05-2020)

  • Fix: Tweaks related to new lightbox designs.

1.6.3 (09-16-2020)

  • Fix: Performance tweaks.

1.6.2 (08-17-2020)

  • Fix: Resolve Facebook sharing (at times with Yoast plugin) issues.

1.6.1 (05-27-2020)

  • Fix: Facebook sharing in lightbox should open new window, not tab.

1.6.0 (03-31-2020)

  • Fix: Adjusted CSS for gallery social icons.

1.5.9 (02-05-2020)

  • Fix: Plugin updater revised.

1.5.8 (12-17-2019)

  • Fix: Resolve issue sharing incorrect Facebook information with dynamic galleries.
  • Fix: Minor bug fixes.

1.5.7 (10-23-2019)

  • Fix: Improve WhatsApp functionality.
  • Fix: Minor bug fixes.

1.5.6 (06-04-2019)

  • Removed: Google+ support.
  • Fix: Link in caption is sharing html code in share window on Facebook.
  • Fix: Minor bug fixes.

1.5.4 (01-16-2019)

  • Added: Depreciate notice for Google+.
  • Fix: Duplication of social icons in legacy lightbox in certain setups.
  • Fix: Resolved minor issues with Pinterest, Facebook and email sharing.
  • Fix: Minor bug fixes.

1.5.3 (10-16-2018)

  • Fix: Resolved issue when social icons were not showing on album Lightboxes in some cases.
  • Fix: Various bug fixes, minor code tweaks, and PHP compatability adjustments

1.5.2 (08-22-2018)

  • Enhancement: French translations updated.
  • Fix: Social icons not appearing in video lightboxes.
  • Fix: Sharing in Google+ not sharing description.
  • Fix: Sharing in Google+ showing improper HTML.
  • Fix: Minor bug fixes.

1.5.1 (05-01-2018)

  • Fix: Minor bug fixes.

1.4.1 (11-07-2017)

  • Fix: Minor bug fixes

1.4.0 (10-18-2017)

  • Fix: Twitter passing HTML
  • Fix: Minor bug fixes

1.3.9 (08-22-2017)

  • Fix: Minor bug fixes

1.3.8 (08-08-2017)

  • Fixed: Priority for metadata
  • Fixed: Social icons on albums not displaying

1.3.7 (06-27-2017)

  • Fix: Minor bugs with Facebook sharing.

1.3.6 (05-16-2017)

  • Fix: Facebook Optional Text

1.3.5 (04-04-2017)

  • Fix: Minor bug fixes

1.3.4 (03-30-2017)

  • Fix: Minor bug fixes

1.3.3 (03-08-2017)

  • Fix: Minor bug fixes (02-02-2017)

  • Fix: Minor bug fixes

1.3.2 (02-01-2017)

  • Fix: Admin check boxes not displaying
  • Fix: Facebook Tags
  • Added: Image size to share for emails
  • Fix: Minor bug fixes

1.3.1 (01-19-2017)

  • Fix: Facebook Lightbox sharing hashtag.
  • Fix: Google+ Descriptions on lightbox sharing.
  • Fix: Issue with sharing and permalink settings.
  • Fix: Minor bug fixes

1.3.0 (2017-01-10)

  • Update: Total rewrite from top to bottom. Added new general settings for Facebook, Twitter, Google+, and Pinterest sharing.
  • Added: Ability to control social icons for mobile for both galleries and lightboxes.
  • Added: Email sharing now includes link to page when possible.
  • Added: Rich Links for Pinterest added (requires Pinterest to approve site).
  • Added: Added social buttons for gallery view for albums.

1.2.6 (2016-12-08)

  • Fix: Clicking lightbox email opens a new window
  • Fix: Missing dependencies
  • Fix: Social icons displaying over video controls
  • Fix: Compatibility with deep linking

1.2.5 (2016-11-03)

  • Added: Support for deep linking when sharing.
  • Fix: Facebook text from being ignored.

1.2.4 (2016-10-4)

  • Update: Ability to determine which Facebook page to share on.
  • Fix: Conflict causing social buttons outside of lightbox with video addon resolved.

1.2.3 (2016-09-16)

  • Update: Pinterest URL in Lightbox view

1.2.2 (2016-09-01)

  • Fix: Icons appearance in lightbox improved.

1.2.1 (2016-08-25)

  • Updated: Spanish translations

1.2.0 (2016-08-04)

  • Fix: Hover stat changed so icons will not disappear in certain instances.

1.1.9 (2016-07-26)

  • Fix: Sharing links now fully work in Lightbox.

1.1.8 (2016-06-30)

  • Fix: Social icons should no longer be out of view on mobile devices when they are outside the lightbox.

1.1.7 (2016-05-19)

  • Fix: Removed duplicate settings
  • Fix: Conditionally show settings based on options chosen
  • Fix: Force social networks to fetch actual shared image and not cached URLs

1.1.6 (2016-05-12)

  • Fix: Pinterest sharing in Lightbox view

1.1.5 (2016-05-05)

  • Updated: Standardised edit screen titles and descriptions
  • Updated: Spanish translation

1.1.4 (2016-04-28)

  • Updated: Spanish Translations

1.1.3 (2016-04-21)

  • Fix: Undefined function inline_notice() error.

1.1.2 (2016-04-21)

  • Added: Option to define Facebook and Twitter text / description when sharing an image from the gallery and/or lightbox view.
  • Updated: Spanish translation

1.1.1 (2016-04-16)

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

1.1.0 (2016-03-31)

  • Updated: Moved settings into own tab on Galleries and Albums
  • Added: Documentation and Video Help Links

1.0.9 (2016-03-10)

  • Added: Option to enable/disable social sharing buttons on mobile

1.0.8 (2016-02-25)

  • Updated: Spanish Translations (2016-01-28)

  • Added: Filters to title and caption in Gallery view for developers to customise titles and captions when using social sharing buttons (2016-01-21)

  • Added: Option to display social sharing buttons outside of lightbox/image frame in Lightbox view (2015-12-11)

  • Fix: Prevent browser tab from closing when social sharing with Facebook is enabled, and URL is opened through a new window.

1.0.7 (2015-12-10)

  • Added: Spanish Translation
  • Added: Automatically close Facebook sharing window when sharing action is completed

1.0.6 (2015-11-12)

  • Fix: Captions with HTML elements not rendering social buttons correctly.

1.0.5 (2015-11-06)

  • Fix: Output correct metadata when multiple Galleries embedded on a single Page.

1.0.4 (2015-08-13)

  • Added: Show a dismissible notice if the Social Addon hasn’t been fully configured at global level with Facebook + Twitter details.

1.0.3 (2015-07-30)

  • Fix: Social sharing on gallery images displayed in the lightbox when accessed through an album.


  • Fix: Moved default settings into global/common.php, so default settings are available to frontend galleries and albums not saved since Social Addon activation.


  • Fix: Lightbox sharing failing when using Deeplinking Addon.


  • Initial release of the addon.