Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Instagram Addon

Are you an avid Instagram user that wants to show off your images? Using Envira’s Instagram Addon you can easily create beautiful Instagram galleries on your site for up to 3 different Instagram accounts! This tutorial will walk you through how to create your first Instagram gallery.



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

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


Step 1 – Enable & Authenticate Instagram

Before you can begin creating Instagram galleries, you’ll first need to let Instagram know you’re giving Envira to use your Instagram images for up to 3 accounts.

Click the Envira Gallery » Settings and select the Instagram tab.

Then select the Click here to Authenticate Your First Instagram Account With Envira button.

Select the button in the Instagram settings tab to authenticate your Instagram account to create your Instagram gallery.

Next, you’ll be prompted to login to your Instagram account if you’re not already logged in.

Click the Authorize button. This connects Envira to your Instagram account.

You'll need to select the Authorize button when prompted to connect Envira Gallery with your Instagram account.

Once the authentication process is completed, you’ll see on screen confirmation.

You'll see you're account is now authorized to create an Instagram gallery

You’ve now authorized just 1 Instagram account. You can repeat these steps 2 more times to authorize up to 3 different Instagram accounts.

Your first step is to create a new gallery. You can easily do this by clicking the Add New link under Envira Gallery from the WordPress admin.

Click Add New to create a new Envira Gallery

Next, click the External Gallery tab from inside the Envira Gallery and select the Instagram icon.

Select the Instagram icon from the External Gallery tab to create an Instagram gallery

On the Gallery tab you’ll see a list of options to choose from to set up your gallery.

Set up your Instagram gallery settings on the Gallery tab

There are some important things to note concerning the Link to Photo? option. If you don’t wish to have the images link at all, simply select No Link from the dropdown. With this option, your visitors wouldn’t be able to click on any of the images in your gallery.

The other two options will be discussed in the next step.

Your next step is optional depending on how you set up your Link to Photo? option in Step 4.

If you selected to have the image link to Original Page at Instagram, you’ll need to make sure the Lightbox and Mobile tab is set to Enable Links? instead of Enable Lightbox?

Enable the external links for your gallery on the lightbox tab

However, if you’ve selected to have the image link to Direct Image On Instagram, you can keep the Enable Lightbox? option checked for the gallery.

Just complete your lightbox options for the Lightbox and Mobile tab with regards to your needs for your Instagram gallery.

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

You’ll see a preview of your Instagram gallery below your gallery settings.

See the preview of your new Instagram galley from your gallery edit screen

See the demo!

Would you like to try creating a similar gallery using images from your blog posts? Why not check out our tutorial on How to use the Featured Content Addon for Envira Gallery.


Q: My Instagram galleries suddenly aren’t displaying. What could be wrong?

A: It might be because Instagram has closed its older API, which Envira Gallery Addons prior to version 1.5 were using (see this support document for more information). If you are experiencing issues: (1) make sure you have upgraded to the latest version of Envira Instagram Addon (the version will be higher than 1.5); (2) then go into Envira settings, click on the Instagram tab, and reauthorize yourself with your Instagram account(s).

Q: Why can’t I set my image sizes?

A: When creating an Instagram gallery, the images only have reading access. This means Envira can only see the images from your Instagram and use the image URLs. Envira does not have the permission to create image sizes or force image sizes with cropping.

Select the image size from the Gallery Tab.

Available image sizes for Instagram gallery images

Q: Why doesn’t the image open the Instagram page?

A: If you have your Instagram settings set to Original Page at Instagram, make sure on the Lightbox and Mobile tab you’ve selected the Enable Links? option for the gallery lightbox settings.

Q: Not all of my images are showing, why?

A: Instagram will only allow Envira to pull up to 33 images with each API call so if you’re setting your gallery to display more than 33 images, Instagram is blocking the rest of the images.


1.6.0 (05-11-2023)

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

  • Fixed: Resolve connection issues.
  • Fixed: Resolve cases that trigger a fatal error. (11-71-2021)

  • Fixed: Resolved pagination issue.
  • Fixed: Resolved fatal error.

1.5.7 (07-01-2021)

  • Added: Ability to add images extracted from Instagram Carousel posts.
  • Fixed: Adding additional images to media library. (05-27-2021)

  • Fixed: Removing test code.

1.5.6 (03-24-2021)

  • Added: ALT text now populated, filter added to adjust ALT text.

1.5.5 (03-10-2021)

  • Fixed: Resolved some PHP errors and notices.

1.5.4 (12-02-2020)

  • Fixed: Resolved issue involving repeating images in smaller galleries.

1.5.3 (09-16-2020)

  • Fixed: Resolved issue involving pagination.

1.5.2 (07-23-2020)

  • Fixed: Resolved issue involving cropping options in settings.
  • Fixed: Resolved issue involving no removing legacy IG accounts.
  • Fixed: Resolved issue involving not showing more than 10 images in certain IG feeds.

1.5.1 (06-18-2020)

  • Updated: Using new Instagram API. Re-authorization might be required. (03-31-2020)

  • Updated: Warning regarding Instagram API expiring June 20th, 2020 with link to Envira online support doc.

1.4.7 (03-09-2020)

  • Added: Warning regarding Instagram API expiring March 30th, 2020 with link to Envira online support doc.

1.4.6 (02-05-2020)

  • Fix: Plugin updater revised.

1.4.5 (12-17-2019)

  • Fix: Code clean up, minor bug fixes, enhanced security.

1.4.4 (06-05-2019)

  • Fix: Code clean up, minor bug fixes, enhanced security.

1.4.3 (12-19-2018)

  • Added: Instagram links will now work even if lightbox 'enable links' is disabled.

1.4.2 (11-07-2018)

  • Fix: Authentication issues.
  • Fix: Cropping issues.

1.3.1 (05-01-2018)

  • Fix: Minor bug fixes.

1.2.1 (10-18-2017)

  • Fix: Cases where Auth’ing fails
  • Fix: Minor bug fixes

1.2.1 (08-08-2017)

  • Fixed: Instagram Links not working

1.2.0 (07-06-2017)

  • Fix: API auth.Fix: Minor bug fixes.

1.1.9 (06-27-2017)

  • Fix: Removed PHP notices.Fix: Add preview window.
  • Fix: Minor bug fixes.

1.1.8 (05-16-2017)

  • Fix: Minor bug fixes.

1.1.7 (04-13-2017)

  • Fix: Minor bug fixes.

1.1.6 (02-15-2017)

  • Fix: Minor bug fixes.

1.1.5 (02-01-2017)

  • Fix: Resolve image limit at 66 images
  • Fix: Minor bug fixes.

1.1.4 (2016-01-10)

  • New API Key
  • Minor bug fixes.

1.1.3 (2016-12-08)

  • UI Enhancement’s
  • Fix: Images sill linking to url if disabled

1.1.2 (2016-11-03)

  • Added: Hi-res image size
  • Added: Open Instagram links in new window

1.1.1 (2016-09-16)

  • Updated: Removed "tag" option due to changes in Instagram API.

1.1.0 (2016-06-30)

  • Updated: Due to new Instagram API changes, we have removed the option to show your favorite Instagrams and Instagrams by hashtag.

1.0.9 (2016-05-31)

  • Fix: Fixing cropping issue.

1.0.8 (2016-05-12)

  • Fix: Don’t try to filter Album Gallery cover image when editing a non-Instagram Gallery in an Album.

1.0.7 (2016-05-05)

  • Updated: Standardised edit screen titles and descriptions (2016-04-22)

  • Fix: Incorrect oAuth callback URL

1.0.6 (2016-04-21)

  • Added: Support for Album Cover Image selection
  • Updated: Spanish translation

1.0.5 (2016-04-16)

  • Added: Live Preview for Envira Gallery 1.5.0+
  • Added: Inline authentication within Gallery Add/Edit screen for Envira Gallery 1.5.0+
  • Fix: Prevent success / error notices on Settings screen from jumping

1.0.4 (2016-03-10)

  • Fix: Don’t show Instagram as a Gallery Type when editing a Default or Dynamic Gallery

1.0.3 (2016-02-25)

  • Updated: Spanish Translations

1.0.2 (2016-01-07)

  • Added: Instagram Galleries can now be displayed within Albums
  • Updated: Spanish translations

1.0.1 (2015-12-03)

  • Added: Spanish translation

1.0.0 (2015-10-07)

  • Initial release of the addon.