Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Debugging Envira

Are you experiencing issues? We are here to help! This documentation shows vital steps and known issues that will get you up and running without ever submitting a support ticket.

We’re always working to improve Envira’s compatibility with other products, but there are a lot of plugins and themes out there. Due to the various customizations that every website has, there is no way to shelter Envira Gallery from conflicts completely. Here are the ones we know about and how to resolve them.

  1. Requirements
  2. Getting Started
  3. Known Issues – Admin
  4. Known Issues – Frontend
  5. Debugging

Envira Gallery requires a minimum PHP version of 5.6. We recommend PHP 7+ as it’s a faster PHP processor. Envira recommends the same requirements that WordPress recommends.

Before submitting a support ticket, you can complete the following debugging steps yourself to identify the cause of the issue and resolve it:

  1. Backup: Always make a backup of your site before debugging, in case you accidentally delete or remove something that you shouldn’t!  This is good practice for any WordPress web site. Learn how to backup your site.
  2. Enable Debugging: Enable debugging for your site to view any PHP errors output when reproducing the issue can help quickly identify the source of the problem. Learn how to enable debugging.
  3. Theme or Plugin Conflict: Checking for a possible theme or plugin conflict is a standard part of the debugging process and should be performed if you’re experiencing unexpected or limited functionality of Envira. Learn how to check for a theme or plugin conflict.
  4. Browser Debugging: You can use your browser to check for javascript errors that might indicate the specific cause of the issue you’re experiencing. Learn how to browser debug.
  5. Mobile Compatibility: Envira only supports the last two versions of iOS for both iPhone and iPad devices.

If after completing the above you’re unable to identify or resolve the issue, please proceed to our Getting Support guide.

Some errors are specific, and we’ve already got steps you can take to resolve them below.

Using Google Chrome’s Console tab, check if there’s an error stating

Uncaught SyntaxError: Unexpected token <


Ask your web host to run your web site on at least PHP 5.6 (note: WordPress recommends using at least PHP 7+)

Another option to check is the Misc Tab on your gallery or album. The slug field should not have any special characters or spaces in this. Spaces in WordPress slugs are represented by hyphens. Also please be sure that each slug name is unique. You should use the same slug name with anything in WordPress including Envira galleries and albums.

Admin: Settings Menu Isn’t Available

If you’re using the X Theme, you’ll need to follow their documentation for enabling the Settings menu item to be visible before you can verify your Envira Gallery license key and access the Addons menu screen.


Follow the X Theme documentation at https://community.theme.co/kb/integrated-plugins-envira-gallery/ (Under the Bundled Version section).

To enable the Settings menu, you’ll need to add the following line of code in your theme or child theme’s functions.php file:

function x_envira_gallery_remove_license_functionality() { return true; }

It could also be that you have not activated the Paid version of Envira but you are still running the Lite version. Please follow these guidelines for upgrading from Envira Lite to the Paid version of the plugin.

Admin: Addons Menu Isn’t Available

In order for the Addons menu to be present, you need to have verified your Envira license on the site.


  1. Head to the Settings page and verify your Envira license.
  2. A new tab called Addons will be available, and you can now use that screen to manage your Envira Addons.

Admin: How to Verify Your License

We have just the doc for you!


Click here to learn how to verify your Envira license.

Admin: Available Envira Update Not Reflected in the Site Updates Area.

Unfortunately, things happen sometimes. This is caused by WordPress not looking for the update when we release it.


After logging into WordPress, navigate to Dashboard » Updates. Simply refresh the Updates page a couple of times, and you should see the update. Refreshing the Updates page causes WordPress to check for updates, and Envira will be added into those updates if there is indeed an update to the plugin (or Addons).

Admin: Error set_time_limit

In order to ensure the best loading and processing of images, we adjust your server’s timeout settings. Some hosts restrict this setting which can result in the following error:

Warning: set_time_limit(): Cannot set max execution time limit due to system policy...


In order to resolve this error, please contact your host to enable the modifying of set_time_limit. Once this is enabled on your server, the error will no longer display.

Admin: Standalone Page Shows a 404

Problems can occur when giving your album or gallery standalone slug the same slug as a post or page, which will prevent your galleries and albums from loading.


In order to resolve this error, we suggest choosing meaningful and specific slugs for your albums and galleries. In addition to resolving this error, such practices will also increase the SEO for your albums and galleries.

Another possible resolution is to go to Settings » Permalinks from your WordPress admin and simply click Save again to flush out the rewrite rules used for finding permalinks in WordPress.

Frontend: Cropping enabled, images not being cropped.

This will happen if you’re using JetPack’s Performance & Speed (formerly called Photon) module and Media Settings which loads the original, full-size, image instead of the image cropped to the specified dimensions.


Disable JetPack’s global Content Delivery Network JetPack » Settings » Performance & Speed.
JetPack Serve Images from Our Servers

When using any CDN to serve your images, Envira will not have the correct permission to create any cropped images for you and this includes the Envira Watermarking Addon.

Frontend: Lightbox is enabled, but images don’t open in lightbox view.

This happens if the Link To field for the image isn’t set to None or Attachment Page when adding from the Media Library. It should be set to Media File in order to auto-populate the URL field for these images in the gallery and trigger the images in lightbox. You can see our Creating Your First Envira Gallery doc for the best way to create galleries.


To correct the issue for any images already added to galleries where they’re not loading in lightbox view:
Lightbox Edit Screen

  1. In the gallery edit screen, select the blue pencil at the top of the image thumbnail.
  2. This will open the Edit Metadata screen, where you can see the URL field.
  3. If this field is empty, select the Media File button to automatically populate the URL field with the URL of the image file.
  4. Select the Save Metadata button at the bottom of this screen before navigating to the next item or closing the Edit Metadata screen.
  5. Update your gallery and check that this resolves the issue.

Using Salient Theme?
If you’re using the Salient Theme, also confirm that Animated Page Transitions are disabled in the Salient » Page Transitions screen.

Frontend: Gallery images opening in two lightboxes on same page.

This will happen if another lightbox script is being loaded by a third-party plugin or your active theme.


Disable the lightbox being loaded by a third-party plugin or active theme on your site. In Avada, for instance, you can disable the theme’s lightbox by navigating to Avada Theme Options » Lightbox and turning the lightbox feature off.

Frontend: Lightbox settings not being applied.

This will happen if another lightbox script is opening the images instead of the Envira Gallery lightbox.


Disable the lightbox being loaded by a third-party plugin or active theme on your site.

Frontend: Lightbox thumbnails are black or missing

There could be a delay on the server with creation of the thumbnails. A few other reasons could be server related as well.


  1. Check with your hosting company that you have Imagick library installed on your server. Envira uses this library to create the image sizes for you on the fly.
  2. If you’re using a CDN to serve your images, check the plugin you’re using to facilitate this to ensure it’s isn’t deleting images from the Media Library after they’re uploaded to your CDN.
  3. Check the file permissions on the images are set to 644 (can also be set to 755) so that Envira has the correct permissions to create these image sizes for you.  If you need assistance on how to check file permissions, take a look at this article from our friends at WPBeginner.

Frontend: [Object object] has no method ‘enviratope’ or [Object object] has no method ‘envirabox’.

This error comes from an issue with loading the Envira script on the page, likely due to a previous script that has loaded in a bug. Check to see if any errors have occurred before it so you can isolate and deal with the bug.


  1. Check to see if there are any other errors in the browser before this one and see if it is indicative of another plugin or theme you are using.
  2. Check for a plugin or theme conflict. If this resolves the issue contact the support of the buggy plugin or theme to resolve the issue.
  3. Clear out your browser cache (especially if the error appears after upgrading Envira). Make you clear it out from the beginning of time in Chrome to ensure that no invalid cache responses remain.

Frontend: Envira Doesn’t Load on the Page

This is due likely to a JS error caused by your theme or a third party plugin.


  1. Make sure that there is only one copy of jQuery being loaded on your site. If more than one copy of jQuery is being loaded, it will overwrite previous jQuery objects and discard anything attached to the previous. It will also slow down your site, so you should remove it anyway. For more information, read this article about managing third-party plugins and themes.
  2. Check your Chrome console for errors. There is likely a JS syntax or parsing error somewhere on the page. Try to resolve the issue by figuring out what script is causing the issue and where it is loaded from (either your theme or another plugin).
  3. Make sure that your theme has this somewhere in the footer.php file (typically located just before the </body> tag):

Frontend: Loading Icon Gets Stuck and Gallery Doesn’t Appear

This means that there was an error loading the Envira script.

  1. Clear out your browser cache. It could be serving an invalid cache file. Make sure to clear it out to the earliest date possible (from the beginning of time in Chrome). Also, flush your plugin and CDN caches if applicable.
  2. Check for a plugin or theme conflict. If this resolves the issue contact the support of the buggy plugin or theme to resolve the issue.

Frontend: Pinterest Buttons Not Showing When Enabled

If you have the WordPress SEO by Yoast plugin installed and activated, it may be necessary to enter the Meta Description field for your galleries before the Pinterest buttons will load properly on the front-end. You can find this below the Envira Gallery settings on the Edit Gallery screen.

Enter the Meta Description field for your galleries before the Pinterest buttons will load properly on the front-end. You can find this below the Envira Gallery settings on the Edit Gallery screen.

WordPress SEO set your metadescription

Frontend: Why Aren’t My Image Sizes Changing?

There can be a few different reasons for not immediately seeing the change to your image size in the gallery.


  • the images you have uploaded to the gallery are large in size
  • your gallery contains a lot of images that are large in size
  • your server is running slow for any reason
  • this could be the result of cookies or caching

If you are linking your gallery images to another page or post (or outside website) this can happen if the Enable Lightbox? is checked on your gallery’s Lightbox and Mobile tabs.


Please review this tutorial on Using External Links in Envira Gallery.

Frontend: Fix Enfold Hover Styles

The Enfold theme has specific hover styles that may not display well with your Envira Gallery.


Add the following code to your theme’s (or a child theme’s) functions.php:

add_filter('envira_gallery_output_before_image', 'enfold_envira_gallery_output_before_image', 10, 5);
function enfold_envira_gallery_output_before_image( $output, $id, $item, $data, $i ) {
	$output = str_replace('envira-gallery-link', 'envira-gallery-link noHover', $output);
	return $output;

Duplicate or Triplicate Lightbox Images

If you are seeing duplicate images in your lightbox and have to click twice or three times to see the next image. Check to see if you’re using a page builder to insert your Envira Gallery shortcode on to the page. Most page builders automatically wrap any text (depending on the module you use) in paragraph tags and that can make the link repeat itself in the lightbox.

If you are using a page builder that gives you the option to uncheck this, uncheck the automatic adding of paragraph tags.

Site Origin automatically wrap in paragraph tags

If you’re page builder doesn’t have this option, see if they have a Shortcode module instead of using a plain text editor module for adding your content to the page.

This will happen if your server or one of your plugins is already using Lazy Load along with Envira’s Lazy Load.

Envira will take all images from your gallery and wrap them in a <noscript> tag so that any visitors coming to your site that do not have javascript enabled browsers can still see your images.

If 2 versions of the lazy load script are trying to load on the same images, this can break those noscript tags causing the images to repeat under the gallery.

If you’re using JetPack’s Performance & Speed (formerly called Photon) module with the Lazy Load option enabled, try disabling the JetPack Lazy Load.

To do this, go to JetPack » Settings » Performance & Speed.
Disable JetPack Lazy Load

Alternatively, you could follow the steps in our tutorial here so that you could use JetPack and Envira Lazy Load together!

Debugging: How Do I Back-up My Site Before Debugging?

A: If you’re unsure how to properly back-up your site please read through
How to Backup & Restore Your WordPress Site with UpdraftPlus
to get started.

Debugging: How Do I Enable Debugging?

A: Add the following to your wp-config.php file:

ini_set('log_errors', 'On');
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Unsure of how to do this? Read How to Edit wp-config.php File in WordPress for more info.
If any errors subsequently occur when using Envira Gallery, they’ll be logged to wp-content/debug.log. If you find this file, send it through as part of your support request – it can be useful to help fix more technical issues.

Debugging: How Do I Check For A Plugin or Theme Conflict?

A: To check for a plugin or theme conflict please follow these steps:

  1. Disable all other plugins.
  2. Activate a default WordPress theme (Twenty-Twenty, Twenty-Nineteen, or Twenty-Sixteen).
  3. Check if the issue you’re experiencing is resolved.
  4. If this resolves the issue, reactivate the theme and each plugin individually and check after each activation if the issue is reproduced again to identify the specific conflict.

Debugging: How Do I Debug In The Browser?

A: When debugging issues or bugs that are visible on the site to any visitor, we also recommend using Google Chrome. When in Google Chrome, do the following:

  1. Visit the webpage where the error is occurring.
  2. Right-click on the page and select the Inspect Element option from the screen popup.
  3. Once the debugging window has appeared, click on the Console tab to the right.
  4. Make a note of any red errors that appear, and include them in your support request.

Now that you’ve covered our debugging guide, it’s time to check out our Getting Support guide.