Envira Gallery Zip Importer - WordPress Plugin
The plugin offers a convenient solution for users of Envira Gallery who need to import galleries from Zip files. With its functionality, users can easily and efficiently transfer multiple images contained within Zip files into their Envira Gallery, streamlining the process of gallery creation and management. This seamless integration simplifies the importing process, saving time for users while ensuring that galleries are set up promptly and effectively.

Plugin Features
Designed to enhance the user experience, the plugin boasts a user-friendly interface that makes it simple for individuals to navigate and utilize its features. Its intuitive design allows users to import Zip files with ease, requiring minimal effort and technical knowledge. This accessibility ensures that users of all levels can benefit from Envira Gallery Zip Importer capabilities, providing a convenient solution for managing galleries within the Envira Gallery platform.
The plugins advanced functionality extends to its ability to preserve the quality and structure of images during the import process. By maintaining the integrity of the images within the Zip file, users can be confident that their galleries will display high-quality visuals without any loss of resolution or clarity. This feature ensures that the imported images retain their original format and appearance, enhancing the overall visual appeal of the galleries created using the plugin.
Additionally, the plugin offers customization options that allow users to configure various settings according to their preferences and requirements. From specifying image display settings to organizing galleries efficiently, users have the flexibility to tailor the import process to suit their specific needs. This level of customization empowers users to create visually appealing and personalized galleries that align with their unique vision and style.
Moreover, the plugin is optimized for performance, ensuring fast and efficient import processes that do not compromise on quality. By leveraging the latest technologies and best practices, the plugin delivers smooth and reliable performance, even when handling large Zip files containing numerous images. This optimization contributes to a seamless user experience, allowing users to import galleries swiftly and effectively without encountering performance issues.
Specifications:
| Release date: | 11-02-2019 | |
| Last updated: | 08-02-2024 | |
| Type: | Paid | |
| License: | GPL | |
| Subject: | Migration & Conversion for Envira Gallery | |
| Compatibility: | W5.x W6.x | |
| Includes: | Plugin | |
| Language packs: |
|
|
| Developer: | Envira Gallery | |
| Rating: | ||
Share with your friends!
Envira Gallery Zip Importer Guide: importing a ZIP archive, configuring the gallery, and checking the final result
Envira Gallery Zip Importer is not about writing a polished gallery description. It solves a very specific operational task: quickly adding a large set of images to Envira Gallery when those images are already packaged in a ZIP archive. In this guide, we will cover more than just the upload step. We will also look at archive prep, WordPress limits, gallery settings after import, publishing on a page, and troubleshooting common failures.
This article is for a site owner, photographer, editor, webmaster, or WordPress administrator who already works with Envira Gallery and wants to avoid manually uploading dozens of images one by one. We will not repeat the general product overview, and we will not discuss buying or obtaining the paid version. The focus here is practical: how to use an add-on you already have access to without ending up with an empty gallery, broken captions, an overly heavy page, or conflicts with lazy loading.
The key idea from the start is this: ZIP Importer only changes how files are added to the gallery. After import, it is still a standard Envira gallery, so it needs the same careful setup you would apply if images were added individually: check metadata, grid layout, cropping, lightbox behavior, mobile display, page embedding, and caching.
What problem ZIP import solves in Envira galleries
In the standard workflow, an editor opens a gallery, selects images from a computer or the media library, waits for the upload, and then manually cleans up the gallery. That works fine when there are only a few files. But for a photo shoot, portfolio, project showcase, event report, or any image series tied to a single item, manual upload quickly becomes a source of errors: some files get missed, the order breaks, the editor accidentally selects an image that was already added, and after publishing it turns out not all thumbnails made it into the grid.
ZIP Importer handles exactly this narrow part of the workflow. The user prepares an archive in advance, opens a new or existing Envira gallery, uploads the ZIP into the Drop files here area or via the Select Files From Your Computer button, and the images should then appear in the Gallery tab grid. Envira's official documentation specifically notes that from that point forward, the gallery behaves like any other Envira gallery. The only difference is the import method.
That leads to one practical conclusion: the add-on is useful when the priority is faster initial population, but it does not replace gallery editing. After upload, you still need to review display settings, captions, alt text, cropping, lightbox behavior, and publishing. If you skip that step, the faster upload process can still produce a weak final page: the images will be there, but they may be poorly described, slow to load, or awkward on mobile.
Where ZIP import saves the most time
The best use cases are batches of images that have already been organized outside WordPress. A photographer delivers a processed set to a client. An editorial team publishes a photo report. A studio uploads a portfolio of completed work. A school or community group posts an event gallery. In each case, it is far easier to prepare one archive than to drag files in one by one and keep checking whether everything made it into the gallery.
- Photo reports where you need to add dozens of images to a single gallery quickly.
- Project portfolios where an editor has already organized the images in a separate folder.
- Work catalogs or case studies where each gallery is created as a standalone Envira item.
- Editorial content where the author sends a finished ZIP archive instead of site access.
- Moving an older image folder into a new gallery without manually selecting every file.
When the add-on will not solve the problem
ZIP Importer is not a full media library migration tool, it does not turn archive folders into a complex album structure, it does not fix server-side upload limits, and it does not automatically optimize photos. If your task is broader - for example, moving galleries between sites, connecting the site to cloud storage, or updating metadata in bulk - you should look at other Envira features or alternative plugins with import and export tools.
Practical rule: if you have one image set for one gallery, ZIP import is a good fit. If you need to sync a cloud folder, import the structure of an older plugin, or move galleries between sites, check for specialized tools first.
What to check before installation and the first import
ZIP import issues often begin before Envira is even involved: an archive is too large, the files are not suitable, the hosting environment is weak, the upload size is limited, the wp-content/uploads folder has permission issues, or an image optimization tool is interfering. That is why it is worth doing a short prep pass before the first real import. It takes less time than trying to diagnose an empty gallery grid after a failed upload.
WordPress version, core Envira Gallery, and add-on availability
The official ZIP Importer documentation lists WordPress and Envira Gallery requirements, as well as the Envira plans that include the add-on. There is no reason to memorize those numbers as a permanent fact because compatibility can change. It is safer to open the current Envira documentation, confirm that your site meets the requirements, and verify that the add-on is visible under Envira Gallery > Addons.
If the add-on card does not appear, do not start by reinstalling the entire site. First, check whether the core Envira Gallery plugin is installed, whether the add-ons screen is available, whether Envira cache is interfering, and whether you need to clear transients using Envira tools. Envira's official add-on activation documentation explicitly ties this type of issue to cache and temporary data.
Upload size limit and server resources
A ZIP archive is a single file, but after upload, WordPress and Envira still need to accept it, unpack it, and add the images to the gallery. If the archive exceeds the allowed upload size, the process can fail before Envira ever gets involved. WordPress shows the actual limit on the media upload screen, and the images themselves are stored in the uploads folder if WordPress has write access.
For your first test, do not use the client's largest archive. Prepare a small set of 5-10 images, upload it, and confirm that the images appear in Gallery. Then gradually increase the batch size. This approach helps you understand the real limit of your site: ZIP size, number of files, PHP memory, request execution time, or thumbnail processing.
Preparing the images inside the ZIP
The archive itself should be simple and predictable. It is best to include only the images you actually need in the gallery, without nested system folders, documents, source files, service files, or unnecessary duplicates. File names should be clear, short, and stable. That makes manual verification easier after import and reduces the chance of odd characters appearing in URLs.
| What to check | Why it matters | Safe action |
|---|---|---|
| Archive size | The server may reject the file before import even starts. | Check the limit in the WordPress uploader and start with a test archive. |
| File types | The ZIP should contain images, not a mixed set of documents. | Keep only the required JPEG, PNG, or other site-supported image formats. |
| File names | Complex characters can sometimes interfere with processing and result checks. | Use short Latin-character names with hyphens, such as project-kitchen-01.jpg. |
| Number of images | A large batch can hit memory or processing time limits. | Split a large shoot into several archives grouped by logical sections. |
| Photo file size | Oversized files slow down the page and make thumbnail generation harder. | Prepare web-ready versions before archiving if the originals are very large. |
Installing the add-on and doing the first check in WordPress
ZIP Importer is installed as an Envira Gallery add-on. The general flow in the official documentation is straightforward: go to Envira Gallery > Addons, find the required add-on, install it, and activate it. At this stage, you do not need to change gallery settings, create new pages, or edit code. The goal of the first check is simpler: make sure the add-on is available in the interface and that the ZIP upload form works inside the gallery editor.
Safe activation order
- Open the WordPress admin panel using an account that can manage plugins and galleries.
- Go to
Envira Gallery > Addonsand find the ZIP Importer card. - If the add-on is available, install and activate it using the standard button in the Envira interface.
- Open
Envira Gallery > Add Newor an existing test gallery. - Check that you can select a ZIP archive in the upload area or drag it into the uploader.
- Upload a small test archive and wait for the images to appear in the gallery grid.
After that, do not rush into importing a live photo shoot. First save the test gallery and open it on the public side of the site. If the images appear in the admin area but are not visible on the page, the issue is no longer the ZIP import itself. It is more likely related to output settings, cache, shortcode, editor block, lightbox, or an optimization conflict.
If the add-on does not appear in the list
Envira's official add-ons documentation recommends checking Envira cache and temporary data when add-ons are unavailable. In practice, that means this order: do not immediately remove the main plugin. Instead, open Envira Gallery > Tools, clear Envira cache and transients, and then refresh the add-ons page. If the card still does not appear, compare your setup against the current official documentation and contact Envira support with the details from System Status.
Quick takeaway: installation is not truly successful when the
Activatebutton disappears. It is successful when a test ZIP actually adds images to the gallery grid and the gallery saves without errors.
How to prepare a ZIP archive so the import works without extra troubleshooting
The most useful ZIP Importer setting is not in the admin panel at all. It is the quality of the source archive. The cleaner the file set, the easier the result is to understand. If you upload an archive full of duplicates, nested folders, editor source files, oversized photos, and random names, you will not save time. You will just create more cleanup work inside the gallery.
Simple archive structure
For a typical site, a flat structure works best: the ZIP contains only the images for one future gallery. Do not assume nested folders will automatically turn into albums, categories, or tags unless the official documentation explicitly says so. The official ZIP Importer instructions confirm ZIP import into a gallery, but they do not confirm complex rules for handling internal archive structure. So in a guide like this, it is safer to work from the simplest scenario.
Example of a good structure
portfolio-kitchen-01.jpg
portfolio-kitchen-02.jpg
portfolio-kitchen-03.jpg
portfolio-kitchen-04.jpg
portfolio-kitchen-detail-01.jpg
This kind of set is easy to verify after import: you can immediately see which series was uploaded, whether the images are in order, and whether anything is missing. If the site contains multiple galleries, create a separate ZIP for each gallery instead of one archive for the entire project.
Example of a structure that should be simplified
final/
final/retouched/
final/retouched/client-selected/
_notes/
thumbs/
project.psd
project-kitchen-final-final-2.jpg
Even if some of these files never make it into the gallery, it still becomes harder for the editor to understand what was actually sent to the site. For a client or content manager, a safer approach is to prepare a dedicated web-gallery folder, place only the final images there, and archive that folder.
Image size and quality
ZIP Importer should not become a way to upload every original file from a photo shoot to the site. A WordPress gallery works better when the source files are already web-ready: sufficient width, reasonable file weight, correct orientation, and a proper color profile. If the site displays images in a grid and lightbox, there is usually no reason to upload overly heavy originals unless the project has a separate requirement for full-resolution downloads through another add-on.
Use the actual site design as your reference point. If the content column never displays images above a certain width, prepare the files for that scenario. That reduces server load during thumbnail generation and lowers the risk of image processing errors. After import, still check quality in the lightbox, because overly aggressive compression can damage a photographer's work or weaken a portfolio.
File order and manual sorting
The official ZIP Importer documentation says images appear in the gallery grid after upload, but you should not promise perfect ordering in every case. The safest practice is to name files in the desired sequence beforehand and then verify the order in the Envira editor after import. If the gallery tells a story, the order matters just as much as the upload itself.
For image series, use prefixes and leading zeros: event-001.jpg, event-002.jpg, event-003.jpg. That makes visual checks easier and helps the editor quickly spot a missing frame.
Importing the ZIP into the gallery and configuring it right after upload
Once the add-on is active, the main workflow happens on the Envira gallery creation or editing screen. In the official instructions, the steps look short: create or open a gallery, upload the ZIP, configure the gallery tabs, click Publish or Update. In real work, it makes sense to add a few checks between those steps, because that is what separates a useful workflow guide from a simple rewrite of the documentation.
Step 1. Create a test or working gallery
Open Envira Gallery > Add New and give the gallery a clear name. The title is not only for the admin area: a week later, the editor should still understand what the gallery contains. For a content site, use the title of the article or event. For a portfolio, use the project type and object. For a catalog, use the work group or collection.
If you are adding images to an existing gallery, make sure it is the correct one before import. Bulk upload is convenient, but it also makes it easy to add a new batch to the wrong gallery. If the gallery is already published on important pages, it is wise to make a copy first or run the import on a draft gallery.
Step 2. Upload the ZIP into the file area
Upload the archive using the Drop files here area or the Select Files From Your Computer button. Do not close the tab until the upload and processing are fully complete. The official documentation notes that depending on the archive size and number of images, they may take some time to appear in the Gallery tab grid. That detail matters: with larger archives, a delay should not immediately be treated as an error.
If the interface does not show clear progress, watch how the browser and server behave. A failed upload, a hanging request, or an empty grid after a long wait is already a reason to start troubleshooting: file size, upload limit, folder permissions, script conflict, or server resource limits.
Step 3. Check the image grid
Once the images appear in Gallery, do not jump straight to publishing. First compare the image count with the source folder, inspect the first and last items, and confirm there are no unexpected files, duplicates, or obviously broken thumbnails. If the series is supposed to follow a specific order, check it now while you are still on the editing screen.
Step 4. Configure the gallery display
ZIP Importer adds the files, but Envira Gallery controls how they look. Go through the gallery settings tabs and review the options that affect the public result: number of columns, spacing between images, image sizes, cropping, gallery description, captions, lazy loading, and lightbox. In the official guide to creating a first Envira gallery, Envira specifically covers columns, margins, row height, title/caption display, image sizes, and cropping.
For a standard content site, it is usually safest to start with a clean grid and lazy loading enabled, as long as it does not conflict with other optimization tools. For a portfolio, composition and lightbox matter more. For a photo report, sequence and captions are more important. For a commercial project showcase, focus on alt text, consistent cropping, and fast page load.
Step 5. Save the gallery and define the expected result
Click Publish or Update, then open the preview or the page where the gallery will be embedded. At this point, it helps to note three expected signals for yourself: how many images should be visible, how they should open in the lightbox, and exactly where the gallery will appear on the page. If something disappears later because of cache or an update, you will have a clear comparison point.
Configuring the gallery after ZIP import: what you should not skip
The most common mistake after a bulk import is assuming the work is finished. In reality, ZIP Importer only delivers files into the gallery. The quality of the page still depends on standard Envira settings, and this stage deserves the same level of attention as a manually built gallery.
Image metadata: title, caption, and alt text
Envira lets you edit image metadata through the pencil icon in the gallery grid. In the official first-gallery guide, the fields Title, Caption, and Alt Text are described directly. After ZIP import, these fields matter even more because the images may have come from a folder with no useful descriptions. If you leave everything as-is, the gallery may look fine visually while losing clarity for both users and search engines.
Do not turn alt text into a keyword dump. Describe the image in a way that helps a person understand what is shown if the file fails to load. For a portfolio, include the object, material, or task. For an event, mention the event and scene. For a catalog, name the type of work or product. Good alt text after ZIP import is part of editorial QA, not decorative SEO formalism.
Columns, spacing, and cropping
The right column count and cropping behavior depend on the image set. If the archive mixes portrait and landscape shots, aggressive cropping can make the grid look tidy while cutting away important parts of the images. If you keep natural proportions, the grid may feel more dynamic but less uniform. There is no universal "best" value - only the right choice for a specific gallery goal.
For interior portfolios and product detail work, preserving detail is often more important, so aggressive cropping should be tested carefully. For a photo report or news page, a more even grid may matter more. In either case, after saving, open the public page on both desktop and a narrow screen so you can evaluate the real result rather than relying only on the admin grid.
Lightbox and mobile behavior
If the gallery is supposed to open images over the page, configure the Lightbox tab. Envira documentation describes separate desktop and mobile lightbox settings, including enabling lightbox on mobile devices, arrows, thumbnails, and swipe-up close behavior. After ZIP import, this becomes more important because a larger image set changes the user flow: the visitor is not just viewing 3 images, but browsing through a series.
Check that the first image opens correctly, the arrows work, captions do not cover key parts of the frame, and mobile users can close the lightbox without confusion. If the images are supposed to link to external pages, also verify the metadata URL and mobile lightbox behavior, because Envira documentation notes that disabling mobile lightbox can remove image links when the page loads.
Lazy loading and cache
For larger galleries, lazy loading is useful, but it is also one of the most common sources of conflict with image optimizers, CDNs, Jetpack, or caching plugins. Envira documentation describes a specific conflict between Envira lazy loading and Jetpack: both tools try to control how images load, and the gallery may display incorrectly as a result. That is why after enabling or changing lazy loading, you should test not only the first screen but also the lower part of the gallery after scrolling.
If the site uses Jetpack or another optimizer, start with the built-in exclusion and cache settings. Only add code filters if you understand where they are stored and how to roll them back. The example below comes directly from Envira's official approach to the Jetpack conflict. Use it through a safe method such as Code Snippets or a child theme, not by editing plugin files.
add_filter( 'envira_gallery_indexable_image_css', 'jp_envira_gallery_indexable_image_css', 10, 2 );
function jp_envira_gallery_indexable_image_css( $css, $id ) {
$css .= 'skip-lazy';
return $css;
}
add_filter( 'jetpack_lazy_images_blacklisted_classes', 'envira_jetpack_lazy_images_blacklisted_classes', 999, 1 );
function envira_jetpack_lazy_images_blacklisted_classes( $blacklisted_classes ) {
$blacklisted_classes[] = 'envira-gallery-image';
$blacklisted_classes[] = 'skip-lazy';
return $blacklisted_classes;
}
add_filter( 'envira_gallery_output_noscript', 'jp_envira_gallery_output_noscript', 999, 2 );
function jp_envira_gallery_output_noscript( $html, $gallery_data ) {
$html = str_replace( '<img ', '<img data-lazy-src="" ', $html );
return $html;
}
After making this change, clear the site cache, Envira cache, and CDN cache if one is in use, then open the page in an incognito window. If the issue is gone, keep the snippet as-is and do not stack additional edits on top of it. If there is no result, disable the snippet and continue troubleshooting without accumulating random code.
Practical scenario: a portfolio gallery from a ready-made ZIP archive
Let us walk through a concrete example, because this is where it becomes obvious where ZIP Importer saves time and where regular editorial work begins. Suppose a studio wants to publish a project page titled "Solid Wood Kitchen" with 24 images: overall views, hardware details, installation process, and final result.
Goal
The goal is to publish a clean Envira gallery on the case study page: the images are imported in one batch, the grid looks orderly, the lightbox shows large photos, key images have useful captions and alt text, and the page does not become unnecessarily heavy.
Preparation
The editor selects only the final web-ready versions of the photos, renames them in sequence from kitchen-solid-wood-01.jpg to kitchen-solid-wood-24.jpg, removes duplicates, and creates the ZIP archive kitchen-solid-wood-gallery.zip. Before the live upload, the editor checks the actual upload limit on the site and creates a small test archive with a few files.
Steps
- Open
Envira Gallery > Add Newand give the gallery a clear project-based name. - Upload the ZIP through the
Drop files herearea or the file selection button. - Wait until all images appear in the
Gallerygrid. - Compare the image count with the source folder and verify the image order.
- Open several key images using the pencil icon and fill in
Title,Caption, andAlt Text. - Configure columns, spacing, cropping, and lightbox for the case study page.
- Save the gallery, insert it into the page using the Envira block or shortcode, and open the public view.
Checking the result
On the published page, all images should be visible, the grid should not break the content width, the lightbox should open a large image, and captions should appear wherever the gallery settings allow them. Be sure to test the mobile version separately: a 24-image series should scroll cleanly without empty gray areas and without trapping the user inside the zoomed view.
A common issue that gets in the way
If the images appear in the gallery editor but the page shows an older version or a blank area, do not re-upload the archive right away. First check whether the correct gallery is embedded, whether Update was clicked, and whether Envira cache, site cache, and CDN cache have all been cleared. Re-importing without diagnosis can create duplicates and make the situation harder to clean up.
Use ideas for different types of sites
ZIP Importer is not only useful for photographers. Its value is removing manual upload work when images are already collected into a batch. Below are several scenarios based on the confirmed ZIP import workflow and standard Envira Gallery features: grid settings, metadata, lightbox, and gallery embedding on a page.
Photo report for a media site or blog
An editorial team receives a set of images from an author, selects the final frames, archives them, and creates a dedicated gallery for the article. Here, speed, image order, and clean captions matter most. After import, it is worth quickly filling in alt text for key images and checking whether the gallery makes the page too heavy.
Service portfolio
For a studio, workshop, designer, or builder, it is convenient to create a separate gallery for each case study. ZIP import helps move a prepared image set quickly, while standard Envira settings help keep the grid visually consistent. In this scenario, cropping needs extra attention because portfolios often include details that should not be accidentally cut off.
Internal event archive
A club, school, nonprofit project, or team can create galleries for events. If the publication does not require advanced commercial image protection, ZIP Importer helps assemble the report page quickly. But if you need restricted access, downloads, proofing, or watermarks, that falls under other Envira add-ons rather than ZIP Importer itself.
Moving an older image folder into a managed gallery
If the site previously stored images in a plain folder or inserted them into pages one by one, you can prepare web-ready versions, build a ZIP, and create a proper Envira gallery. This is not a full migration from an older plugin, but it is a solid way to turn one image set into something manageable: a standalone gallery entity with consistent settings and a shortcode or block for embedding.
How to embed the finished gallery on a page and verify public output
After ZIP import and gallery setup, the gallery still needs to be displayed on a page. Envira supports insertion through the WordPress editor and through a shortcode. The official Gutenberg documentation also notes that you can use the Envira block or the Shortcode block, and for some use cases the shortcode remains the most universal option. What matters to the user is not the method itself, but confirming that the public page displays the exact gallery you just configured.
Embedding via block or shortcode
If the site uses the block editor, try adding the Envira Gallery block and selecting the needed gallery from the list. If the block is unavailable or you are working with a template, widget, page builder, or the classic editor, use the shortcode from the Envira Code block in the gallery editor. Do not rewrite the shortcode by hand if you can copy the ready-made code. That reduces the risk of using the wrong ID.
What to check after embedding
- The page shows the correct gallery, not an older test version.
- The number of images matches the expected set.
- The lightbox opens and closes correctly on both desktop and mobile.
- Captions and titles display in the chosen mode rather than disappearing because of the theme.
- The page does not show blank areas after scrolling if lazy loading is enabled.
- The result remains the same after clearing cache.
Checking page speed and page weight
A large gallery almost always affects how a page feels. Even if Envira is optimized for galleries, bulk import does not override the basic reality of images: oversized files, too many thumbnails above the fold, and conflicting lazy load settings can still hurt user experience. Do not assume ZIP import automatically makes the page fast. It speeds up gallery creation. Performance still needs to be checked separately.
A practical check is simple: open the page in a private window, scroll through the gallery, open several images in the lightbox, and then test the mobile version. If the page feels heavy, start by reducing the source image sizes and adjusting the number of columns rather than turning off features at random.
Why import or display may fail and how to troubleshoot it
ZIP Importer troubleshooting should follow a chain: file - WordPress upload - Envira processing - gallery save - public output - cache and optimization. If you skip steps, it becomes easy to fix the wrong problem. For example, an empty gallery on a page may not be a ZIP import issue at all. It may simply be stale cache or the wrong shortcode.
The ZIP will not upload or WordPress shows an error
Symptom: the uploader rejects the file, shows a size error, the request hangs, or WordPress returns a generic upload error.
Possible cause: the archive exceeds the actual upload limit, the server runs out of time or memory, the uploads folder is not writable, or the archive contains overly heavy images.
What to check
- The actual limit on the
Media > Add Newpage or in the upload interface. - The ZIP size and the size of individual images inside the archive.
- Permissions on the
wp-content/uploadsfolder and whether a normal single-image upload works. - Hosting logs if the upload stops without a clear message.
How to fix it: shrink the archive, split the batch into several ZIP files, prepare lighter web-ready versions of the images, or ask the hosting administrator to check PHP limits. If even a single image will not upload to the media library, fix the general WordPress upload flow first, not Envira.
The archive uploaded, but the images did not appear in the grid
Symptom: the upload seems complete, but the Gallery tab is empty or shows fewer images than expected.
Possible cause: processing did not finish, the archive contained unsupported files, the server interrupted extraction, or some images failed during thumbnail generation.
What to check: try the same archive in a test gallery with fewer files, inspect the ZIP contents, upload 2-3 images the standard way, and confirm that the media library works. If a small batch succeeds and a large one does not, the problem is almost certainly the batch size or server resources.
When to roll back: if a second attempt created duplicates, delete the test gallery or remove the extra images manually, then repeat the import using a smaller archive. Do not keep uploading the same large ZIP over and over.
The gallery exists in the admin area, but it is not visible on the page
Symptom: the images are present in the Envira editor, but the public page shows a blank area, an older gallery, or the shortcode as plain text.
Possible cause: the wrong shortcode was inserted, the page was not updated, the block was not selected, the theme template is not rendering content correctly, or cache is serving an older version.
How to fix it: copy the shortcode from the current gallery again, update the page, clear Envira cache and site cache, and test the output on a simple page without a page builder. If it works on a simple page, the conflict is likely in the template, the builder, or the specific insertion point.
Images load as gray blocks or disappear when scrolling
Symptom: the first images are visible, but farther down you see empty areas, gray thumbnails, or the lightbox opens something unexpected.
Possible cause: a lazy loading conflict between Envira and a third-party optimizer, a CDN rewriting paths, cache serving outdated markup, or images not finishing processing in time.
How to fix it: temporarily disable third-party image optimization or exclude Envira classes from its processing, then clear cache and test the page in a private window. If Jetpack lazy load is in use, Envira provides a separate official guide for excluding Envira images from Jetpack processing.
The lightbox will not open the image or links are missing on mobile
Symptom: thumbnails are visible, but clicking does not open the lightbox; on mobile, the images do not lead to the expected URL.
Possible cause: lightbox is disabled on desktop or mobile, the image metadata does not contain a URL, the selected lightbox theme limits caption output, or a script conflict is blocking the click handler.
How to fix it: check the Lightbox tab, then the Mobile tab, open the metadata for the specific image via the pencil icon, and make sure the URL is filled in if it is required. After saving, clear cache and test the page without JavaScript minification.
Limitations and safe solutions without unnecessary code
With ZIP Importer, it is important not to assign capabilities to the add-on that are not confirmed by the sources. The official instructions describe uploading a ZIP into a gallery and then configuring that gallery, but they do not confirm advanced scenarios such as automatically turning archive folders into albums, intelligent deduplication, reading all EXIF/IPTC data, or sorting by archive-specific rules. Any expectations like that should be tested in a sample gallery rather than treated as a built-in feature.
Safe improvements that actually make sense
The best improvements for this add-on usually do not require code at all: prepare web-ready images before building the ZIP, name files consistently, fill in alt text after import, enable lightbox only where it helps, test mobile lightbox, exclude the gallery from conflicting lazy loading, and clear Envira cache after changes.
Code should only be used in narrow cases where it is supported by Envira documentation or obvious WordPress logic. The Jetpack example above is exactly that kind of case: it does not modify WordPress core, it does not edit Envira files, and it can be turned off via Code Snippets. For everything else, it is safer to look for an interface setting first or consult Envira documentation.
What you should avoid
- Do not edit core Envira or WordPress plugin files for the sake of a single import.
- Do not upload the same large ZIP multiple times without cleaning duplicates and understanding the failure.
- Do not promise a client that ZIP Importer will automatically fill every caption and SEO metadata field.
- Do not permanently disable all caching and optimization plugins if the issue can be fixed with a targeted exclusion.
- Do not use questionable sources to obtain the add-on files. For a live site, updates, compatibility, and support matter.
Questions that usually come up after the first ZIP import
Can Envira Gallery Zip Importer be used without the main Envira Gallery plugin?
No. It is an add-on for Envira Gallery. The main plugin must be installed and working first, and then the add-on adds a ZIP-based image upload method. If Envira Gallery itself is missing or broken, ZIP import will not solve the issue.
Do I need to configure the gallery after uploading the ZIP?
Yes. ZIP import adds the images, but the output behavior is still controlled by the Envira gallery settings. After upload, check the grid, order, metadata, lightbox, mobile lightbox, lazy loading, and the method used to embed the gallery on the page.
Why is it better to test with a small archive first?
A small archive helps separate an add-on issue from a server issue. If 5 images upload and 80 do not, the site is most likely hitting limits related to ZIP size, memory, processing time, or thumbnail generation. That is much easier to diagnose than starting with a large production archive.
Are folders inside the ZIP preserved as albums or tags?
The official ZIP Importer documentation confirms importing images from a ZIP into a gallery, but it does not confirm automatic creation of albums or tags from the archive folder structure. For reliable results, use a simple structure and test any more advanced expectations in a sample gallery first.
What should I do if the add-on is installed but the import button is missing?
Make sure you are on the Envira gallery creation or editing screen, not the standard WordPress media library. Then clear Envira cache and transients via Envira Gallery > Tools. If the add-on still does not appear, compare your setup against the current Envira documentation and the System Status data.
Can I import very large photo shoots as a single archive?
Technically, a lot depends on your hosting environment, upload limit, and server resources. In practice, it is safer to split a large shoot into several logical archives. That makes recovery after a failure easier, keeps order easier to verify, and reduces pressure on thumbnail processing.
Will ZIP Importer make the public gallery page load faster?
Not directly. It speeds up gallery creation, not page loading for visitors. Performance depends on image size, the number of items on the page, lazy loading, cache, CDN, and gallery settings. After import, performance still needs to be tested separately.
When Envira Gallery Zip Importer is the right choice
Envira Gallery Zip Importer is a strong fit if you already use Envira Gallery and regularly build galleries from pre-prepared sets of images. Its main value is reducing the manual work of uploading a batch of files while preserving the familiar Envira workflow: grid management, metadata, lightbox, shortcode, or block-based embedding.
Before using it on live content, run a small test import, check the upload limit, prepare a clean archive, and configure the gallery after the images appear. If the result on the page matches expectations, you can move on to real projects and get the WordPress version from the download section on this page.
If instead you need to migrate galleries between different plugins, automatically sync a cloud folder, export between sites, or manage albums in a more advanced way, ZIP Importer may be only one part of the process. In that case, compare it with Dropbox Importer, NextGEN Gallery, FooGallery, Modula, or Photo Gallery by 10Web, and choose the tool based on the real workflow rather than the feature name alone.


