Create Beautiful Responsive Photo & Video Galleries For Your Site in Minutes

Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

How to Let Visitors Upload Photos with Envira Frontend Submissions

The Frontend Submissions addon turns a gallery into a two way gallery. Instead of only showing your photos, it puts an upload form on your site so visitors can add their own.

Visitors do not need a WordPress account and they never see your dashboard. They pick their photos, upload them, and you decide whether each photo goes live. It is a good fit for event photos, photo contests, community galleries, and client galleries where other people are doing the shooting.


Requirements

  • An Envira Gallery Pro, Agency, or Elite license
  • The Frontend Submissions addon installed and activated
  • At least one Envira gallery
  • A page or post where you want the upload form to appear

Note: Frontend Submissions is a Pro feature. On a Basic or Plus license the Submissions tab shows an upgrade screen instead of the settings, and the form does not render on the front end.


Step 1: Turn On Submissions for a Gallery

Submissions are switched on one gallery at a time, so you can collect photos in one gallery while your other galleries stay closed.

From your WordPress dashboard, click Envira Gallery in the left hand menu, open the gallery you want to collect photos in, then click the Submissions tab.

Vertical left navigation panel with menu items: Gallery, Configuration, Lightbox, Mobile, Standalone, Payments, Submissions (green highlight), Misc.

Check Enable Submissions. The rest of the settings on the tab appear as soon as you do.

Enable Submissions checkbox is checked; Allow visitors to submit photos to this gallery.

Here is the full tab with everything switched on:

Frontend Submissions settings panel with toggles for enabling submissions, moderation, and field visibility, plus form texts like title and button label.

The settings do the following:

SettingWhat it does
Enable SubmissionsSwitches the upload form on for this gallery. Nothing else on the tab applies until this is checked.
ModerationHold for Review keeps each photo hidden until you approve it. Auto-Approve publishes photos the moment they are uploaded.
Show Name FieldAdds a First Name field to the form. The name is saved with the photo and shown to you when you review it.
Show Email FieldAdds an Email field to the form. The address is saved with the photo and is only ever visible in your dashboard.
Spam ProtectionApplies your site wide spam screening to this gallery’s form. See Step 3.
Form TitleThe heading above the form. Leave it empty to show no heading.
Button TextThe label on the upload button, for example “Upload Photos”.
Success MessageWhat the visitor sees after a successful upload.
Error MessageWhat the visitor sees if the upload fails.

Click Update to save the gallery when you are done.

Note: The name and email a visitor types are stored with the photo for your reference only. They are never included in the gallery output your visitors see, even after the photo is approved.


Step 2: Choose How Photos Are Approved

Moderation is the setting that decides what happens the second a photo lands on your site.

  • Hold for Review is the safer choice and the default. Uploaded photos stay hidden from the gallery until you approve them, so nothing appears on your site without you seeing it first.
  • Auto-Approve publishes every upload immediately. Use it for a closed event or a trusted audience where waiting for approval would get in the way.

You can change this at any time. Switching to Auto-Approve does not approve the photos already waiting in the queue, so anything already pending still needs your review.


Step 3: Set Up Spam Protection

An upload form that anyone can use will attract bots sooner or later, so the addon ships with protection built in and lets you add another layer on top.

Always on, with nothing to configure:

  • A hidden honeypot field that bots fill in and people never see
  • A security token check on every submission
  • File type checks that confirm each upload is a real image, not a renamed file
  • A rate limit of 10 uploads per hour from a single IP address

On top of that you can add a CAPTCHA or the ActiveLayer spam service. You pick one method for the whole site, then switch it on for the galleries that need it.

Go to Envira Gallery > Settings and click the Frontend Submissions tab.

Horizontal navigation bar with tabs: General, Standalone, Permissions, Image Licensing, Convert to Envira, Image Assistant Settings, Compression Beta, Payments, Frontend Submissions; dark left edge and a green circular action on the right.

Pick one of the three options under Spam Protection.

CAPTCHA works with a CAPTCHA plugin you already run. Envira supports hCaptcha for Forms and More, Simple Cloudflare Turnstile, and Advanced Google reCAPTCHA. Install and configure one of them the normal way and Envira picks it up on its own, with nothing to enter here. If none is installed, this tab tells you so.

ActiveLayer screens submissions through the ActiveLayer service instead, with no puzzle for your visitor to solve. Choose it, paste the API key from your activelayer.com account, and save.

Spam protection: ActiveLayer selected; API key field masked; Save button.

Click Save, then go back to the gallery’s Submissions tab and check Spam Protection there. The description next to the checkbox confirms which method that gallery will use.

Settings panel: Email field shown, spam protection off, and form title set to 'Share Your Photos'.

Note: The per gallery Spam Protection checkbox stays greyed out until a usable method is set on the settings page. If you picked CAPTCHA but no supported CAPTCHA plugin is active, or you picked ActiveLayer but left the API key empty, there is nothing for the gallery to switch on yet.

If you run more than one supported CAPTCHA plugin, Envira picks one for you and shows a notice offering to let you choose. A Prefer a specific one? dropdown appears on the settings tab in that case.


Step 4: Add the Form to a Page

Enabling submissions does not put the form anywhere on its own. You add it to a page in one of two ways.

Using the Block

In the block editor, click the block inserter, search for Envira Submissions Form, and add it.

Envira Submissions form panel with a green logo and a search box labeled 'Envira Submissions'.

With the block selected, open the block settings panel on the right and pick your gallery under Submissions Settings.

Web page titled Village Summer Festival with a shortocode block and an EnviraGallery submissions form banner reading TEST at the bottom of the page.

The Gallery dropdown only lists galleries that have submissions enabled. If yours is missing, go back and finish Step 1.

Using the Shortcode

If you are not using the block editor, or you want the form inside a widget, a template, or a page builder, use the shortcode instead. Open the gallery and look in the Envira Code box in the sidebar. The submissions shortcode is at the bottom, and the clipboard icon copies it for you.

Envira Code panel showing gallery shortcodes: by id, by slug, link shortcode, template tag, and submissions shortcode.

It looks like this, with your own gallery ID:

[envira_submissions gallery_id=”7″]

The form and the gallery are separate, so you can put them on the same page or on different pages. A common setup is the gallery at the top of a page with the upload form underneath it.


What Your Visitors See

This is the form on the front end, with both optional fields switched on:

Share Your Photos form: fields for First Name and Email with an image upload area below, plus a Browse Files button and Upload Photos CTA.

Visitors can drag photos onto the upload area or click Browse Files to pick them. Each photo appears as a thumbnail below the drop area, with an x to remove it, and the upload button stays disabled until at least one photo is chosen.

Form titled 'Share Your Photos' with First Name and Email fields and a large drag‑and‑drop image area; green 'Upload Photos' button visible.

After the upload finishes, your Success Message appears under the upload button, and the thumbnails and text fields clear so the form is ready for another submission.

Share Your Photos form: name and email inputs above a large drag-and-drop image area with a Browse Files button and a queued-upload success notice.

If the gallery is set to Hold for Review, the photo is now waiting in your dashboard and is not visible in the gallery to anyone yet.


Step 5: Review Submitted Photos

Open the gallery and stay on the Gallery tab. Photos waiting for review appear in a User Submitted Photos panel above your published images.

Moderation panel showing four user-submitted photos labeled PENDING, with Approve/Delete actions and each card shows title, date, and author.

Each photo shows its file name, the date it arrived, and the submitter’s name if they gave one. Hover over a photo to reveal its buttons:

  • Approve adds the photo to the gallery. It appears on your site straight away.
  • Delete removes the submission and deletes the uploaded file for good.

The buttons at the top of the panel, Approve All and Delete All, do the same thing to every pending photo at once. The two delete actions ask you to confirm first, because they cannot be undone.

Approved photos drop into the image grid below the panel right away. When the last pending photo has been handled the panel is replaced by a short confirmation, and it comes back the next time someone uploads.

Note: Deleting a submission permanently removes the image file from your media library. There is no undo, so use it for spam and photos you do not want rather than as a way to tidy up.


Keeping Track of Submissions

You do not have to open a gallery to know whether photos are waiting.

The Visitors Submissions box in the gallery sidebar shows the moderation mode, the number of pending photos, and a button that jumps straight to the review panel. The number in the box title is a quick badge you can read at a glance.

Moderation dashboard: Visitors Submissions with 4 pending images awaiting review and a green Review 4 Images button.

The galleries list gets a Submissions column too, so you can scan every gallery at once.

Admin dashboard row for 'Village Summer Festival' with thumbnail, shortcode , and a highlighted 4 Pending submissions.

The column shows one of three things:

  • N Pending when photos are waiting for review
  • Approved when submissions are on and nothing is waiting
  • A dash when submissions are switched off for that gallery

Email Notifications

Every submission sends one email to your site’s admin address, the one under Settings > General in WordPress. The email names the gallery, says how many photos arrived, and links to the gallery editor so you can review them.

A visitor who uploads five photos at once triggers a single email, not five.

If the mail never arrives, the cause is almost always WordPress email delivery in general rather than this addon. An SMTP plugin such as WP Mail SMTP usually fixes it.


Upload Limits

These limits apply to every submission form:

LimitValue
File typesJPG, PNG, GIF, and WEBP
Maximum file size10 MB, or your server’s upload limit if that is lower
Photos per submission10
Submissions per hour10 files per hour from one IP address

The form shows the real numbers for your server under the upload area, so a visitor sees the limit that actually applies. Files that are too large or the wrong type are rejected in the browser before anything is uploaded, and the visitor gets a message naming the file.


Troubleshooting

The form does not appear on my page. Check that Enable Submissions is checked on the gallery and that the gallery was saved afterwards. Then check that the shortcode or block points at that same gallery ID. If you are on a Basic or Plus license, the form does not render at all, and logged in administrators see a short note saying a Pro license is required.

Uploaded photos are not showing in the gallery. That is Hold for Review doing its job. Open the gallery, look at the User Submitted Photos panel on the Gallery tab, and approve the photos you want to keep. Switch Moderation to Auto-Approve if you would rather skip the review step in future.

A visitor sees “Too many submissions. Please try again later.” They have hit the rate limit of 10 files per hour from one IP address. It clears on its own after an hour. If your visitors legitimately upload more than that, raise it with the envira_submissions_rate_limit filter.

The Spam Protection checkbox in the gallery is greyed out. No usable method is set for the site yet. Go to Envira Gallery > Settings > Frontend Submissions and either pick CAPTCHA with a supported CAPTCHA plugin active, or pick ActiveLayer and enter your API key.

A visitor sees “File is too large” or “Invalid file type”. The file is over the limit shown under the upload area, or it is not a JPG, PNG, GIF, or WEBP. These checks happen in the browser, so the upload never starts. Ask for a smaller or converted copy.

Approved photos still are not visible on the page. Approving a photo clears that gallery’s cache automatically. If you also run a page caching plugin or a CDN, clear that cache too so the page itself is rebuilt.


Still stuck? Get in touch with our support team and we will take a look.

The Best Drag and Drop WordPress Gallery Plugin

Envira Gallery: Create, Showcase, and Sell Your Work – Trusted by 150k+ Sites.

Enter the URL of your WordPress website to install

Upgrade to Envira Gallery Pro

Unlock even more powerful features designed to make your galleries even more beaituful.

Video Galleries

eCommerce

Social media Sharing

Adobe Lightroom

And much more!

Copyright © [#this year :%Y] Envira Gallery, LLC. Envira Gallery is a trademark of Envira Gallery, LLC.