Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Troubleshooting

Forminator File Upload Not Working: Causes and How to Fix It

Forminator File Upload Not Working: Causes and How to Fix It

Short answer

Forminator file uploads usually fail because the file breaks the field's type or size rules, PHP upload limits are too low, the uploads folder is not writable, or a firewall, cache or script conflict blocks the request. Check the field settings first, then server limits.

Key takeaways

  • Each File Upload field has its own type and size rules.
  • PHP limits cap uploads regardless of field settings.
  • 413 and 403 errors need server or firewall fixes.
  • Entries without files suggest folder permission problems.
  • Turn on attachments in notifications to email files.
  • Exclude form pages and scripts from caching.

Why is the Forminator file upload not working?

Forminator file uploads usually fail because the file breaks the field's size or type rules, PHP upload limits are too low, the uploads folder is not writable, or a firewall, cache or script conflict blocks the request.

Forminator is a free form builder from WPMU DEV. Its File Upload field lets visitors attach documents and images to a form entry.

Common symptoms include:

  • An error saying the file type is not allowed.
  • A message that the file is too large.
  • A form that submits but the entry has no attachment.
  • A spinner that never finishes after clicking Submit.
  • Files that save but never show up in the notification email.

This guide works through each cause in order. If the form itself does not display, start with our guide on Forminator not showing.

What are the common causes at a glance?

Most upload failures fall into a few groups, so match your symptom first and then follow the related section below.

SymptomLikely causeFirst fix
File type not allowedType not enabled in field settingsAllow the type in the field
File too largeField limit or PHP limitRaise both limits
Spinner never stopsBlocked AJAX request or script errorCheck console and firewall
Entry saved without fileFolder not writable or disk fullFix permissions and space
File missing from emailAttachment option off or mail size limitEnable attachments, check size
Works for admin onlyCache serving old formExclude form page from cache

Keep your browser developer tools open while testing. They show most of these problems directly.

Are the field's file type and size settings correct?

If Forminator rejects a file, check the File Upload field's settings first, because each field has its own allowed file types and maximum file size.

Open the form in Forminator > Forms, click the File Upload field and look at its settings. You can usually choose:

  • Whether the field accepts a single file or multiple files.
  • Which file types are allowed.
  • The maximum file size, and for multiple uploads, a limit on the number of files.

Make sure the type your visitor is sending is ticked. A PDF field will not accept a DOCX file, and an image-only field will not accept a HEIC photo from an iPhone unless that type is allowed.

The Forminator documentation on WPMU DEV describes each field option in more detail.

Is the server's PHP upload limit too low?

If larger files fail even though the field allows them, PHP's upload limits are probably lower than the field setting, so raise upload_max_filesize and post_max_size on the server.

Forminator cannot accept a file larger than PHP allows. The lowest limit always wins.

The PHP core settings reference explains both values. post_max_size must be at least as big as upload_max_filesize, and bigger if visitors send several files at once.

Ways to raise them:

  • Change PHP settings in your hosting control panel.
  • Edit php.ini or .user.ini if your host allows it.
  • Ask your host's support team.

Our guide on increasing max upload size in WordPress covers each method step by step.

Is a 413 or 403 error blocking the upload?

A 413 status means the web server rejected the request as too large, and a 403 means a firewall rule blocked it, so both need fixing outside Forminator.

Open the Network tab in your browser's developer tools and submit the form. Look at the failed request and its status code.

  • 413 is explained on MDN's 413 status page. Your host may need to raise the web server's request body limit.
  • 403 usually comes from ModSecurity, a security plugin or a CDN firewall flagging the upload.

Ask your host to check firewall logs at the exact time of the failure. Our guide on fixing the 403 forbidden error lists the usual sources.

Is the uploads folder writable?

If the form submits but the entry has no file, Forminator may not be able to save it inside wp-content/uploads, so check folder permissions, ownership and free disk space.

Forminator stores uploaded files within the WordPress uploads directory. If WordPress cannot write there, the file is lost even though the entry saves.

Check these points:

  • Folders usually need 755 permissions. See our guide on setting correct file permissions in WordPress.
  • The folder owner should match the user your web server runs as.
  • Your hosting account must have free space.
  • Normal Media Library uploads should work. If they fail too, the problem is server-wide.

The WordPress.org page on changing file permissions explains the background if you are unsure.

Is a script error or cache stopping the upload?

Forminator submits forms in the background, so a JavaScript error from another plugin or a cached copy of the form can leave the upload stuck or failing for visitors.

Check the browser console while you add a file and submit. Red errors point to the script at fault.

Common culprits:

  • Optimisation plugins that delay, combine or minify Forminator scripts.
  • Page caching that serves an old copy of the form with an expired security token.
  • A theme or plugin loading an outdated script library.

Exclude Forminator scripts from optimisation features and exclude the form page from page and CDN cache. Our guide on clearing cache in WordPress shows how to purge each layer.

If the form looks wrong as well, our guide on Forminator CSS not working covers styling conflicts.

Why are uploaded files missing from the notification email?

If files save to the entry but do not reach the inbox, the email notification may not be set to attach them, or the attachment is too large for your mail service.

Open the form's Email Notifications settings and check whether file attachments are enabled for that notification.

Also consider:

  • Many mail services limit total message size, so large files may be stripped or the email rejected.
  • Sending a link to the file instead of attaching it is often more reliable.
  • Emails sent through the server's default mail function often fail. An SMTP plugin helps.

Our guide on Forminator email notifications not working covers mail delivery problems in depth.

Could a plugin or theme conflict be the cause?

Yes, another plugin or your theme can interfere with uploads, so run a conflict test on a staging copy with only Forminator active and a default theme.

Follow these steps:

  1. Create a staging copy of the site.
  2. Switch to a default theme such as Twenty Twenty-Five.
  3. Deactivate all plugins except Forminator.
  4. Test the upload.
  5. Reactivate plugins one by one until it fails again.

Our plugin conflict guide explains the method in more detail. Also update Forminator from the WordPress.org plugin page or your Plugins screen, since upload fixes ship in regular releases.

How do you test uploads after fixing them?

Test with a small file, a file close to your limit and a blocked type, while logged out in a private window, and confirm each behaves as expected.

A quick test plan:

  • Upload a small PDF and check that it appears in Forminator > Submissions.
  • Upload a file just under the size limit.
  • Try a type you do not allow and confirm the error is clear.
  • Test on a phone, since mobile cameras create large image files.
  • Confirm the notification email arrives with the file or link.

Repeat the test after major plugin or hosting changes.

When should you contact Forminator support?

Contact support when uploads still fail after checking field settings, PHP limits, permissions, firewalls and conflicts, and include the exact error, file size and type, and your PHP version.

Free users can post on the Forminator support forum on WordPress.org. WPMU DEV members can also use the live support inside their account.

Include these details:

  • The form ID and File Upload field settings.
  • Any console or Network tab errors.
  • Your host, PHP version and Forminator version.

Clear details speed up the answer. For a full walkthrough of building forms, see our guide on using Forminator in WordPress.

Frequently asked questions

How do I increase the Forminator file upload limit?

Raise the maximum size in the File Upload field settings, then make sure PHP allows it. upload_max_filesize and post_max_size on the server must be at least as large as the field limit, or uploads will still fail.

Why does Forminator say the file type is not allowed?

The type is not enabled in the File Upload field settings. Open the field, tick the type you need or add it as an allowed type, and save. Avoid allowing script or executable files for security reasons.

Where does Forminator save uploaded files?

Forminator stores uploads inside the WordPress uploads directory and links them to the submission. You can view and download them from the submissions screen for that form.

Why is my Forminator upload stuck on loading?

A stuck spinner usually means the background request failed. A firewall may block it, a script error may stop it, or a cached form may hold an expired token. Check the browser Network tab for the failing request.

Can Forminator attach uploaded files to emails?

Yes. In the form's email notification settings, you can choose to include uploaded files as attachments. Large files may exceed mail size limits, so sending a link can be more reliable.

Sources

  1. Forminator documentation WPMU DEV
  2. Forminator plugin WordPress.org
  3. php.ini core directives PHP Manual
  4. 413 Content Too Large MDN Web Docs
  5. Changing File Permissions WordPress.org

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.