Troubleshooting
Gravity Forms File Upload Not Working: Causes and How to Fix It

Short answer
Gravity Forms file uploads usually fail because the file exceeds the field or PHP size limit, the extension is not allowed, the uploads folder is not writable, or a firewall, cache or script error blocks the request. Check the field settings first, then server limits and conflicts.
Key takeaways
- The smallest of the field and PHP limits wins.
- List each allowed extension without the dot.
- Entries without files often mean folder permission problems.
- 413 and 403 errors come from the server or firewall.
- Exclude form pages from page and CDN cache.
- Run a conflict test on staging to find culprits.
Why is the Gravity Forms file upload not working?
Gravity Forms file uploads usually fail because the file is larger than the field or server limit, the file type is not allowed, the uploads folder is not writable, or a firewall, cache or script error blocks the upload request.
The File Upload field is one of the most useful parts of Gravity Forms. It lets visitors send CVs, photos, invoices and other documents with their entry.
When it breaks, you might see:
- An error saying the file type is not allowed.
- A message that the file exceeds the size limit.
- A multi-file upload that sticks at 0% or spins forever.
- A form that submits but has no file attached to the entry.
- A blank page or 413 error after clicking Submit.
This guide covers each cause in turn. If the whole form is broken, not just uploads, start with our guide on Gravity Forms not working.
What are the common upload problems at a glance?
Matching the symptom to a cause first saves time, because size, type, permission and request problems each have different fixes.
| Symptom | Likely cause | First fix |
|---|---|---|
| File type not allowed | Extension missing from field settings | Add the extension to Allowed file extensions |
| File too large message | Field limit or PHP limit | Raise both limits |
| 413 error on submit | Web server request size limit | Ask host to raise the body size |
| Multi-file stuck at 0% | JavaScript error or blocked request | Check console, test conflicts |
| Entry saved without file | Folder not writable | Fix uploads folder permissions |
| Works logged in, fails logged out | Page cache or expired token | Exclude the form page from cache |
Use the table to pick your starting point, then read the matching section.
Is the file larger than the allowed size?
If the file is bigger than the field's Maximum File Size or the server's PHP limits, the upload is rejected, so check both and raise the lower one.
There are two separate limits to keep in mind:
- The field limit. In the form editor, open the File Upload field and look for the maximum file size option. Gravity Forms shows its File Upload field settings in its documentation.
- The server limit. PHP's upload_max_filesize and post_max_size set the hard ceiling. The PHP core settings reference describes both.
If the field allows 50 MB but PHP only allows 8 MB, uploads over 8 MB still fail. The smallest limit always wins.
Our guide on increasing max upload size in WordPress shows how to raise the PHP values through your host, php.ini or .htaccess.
For multi-file uploads, the total of all files in one submission also matters. Ask visitors to compress large files or split them across fields if your host limits are tight.
Is the file type blocked?
If the visitor sees a file type error, the extension is either not listed in the field's Allowed file extensions box or blocked by WordPress for security, so add the extension or choose a safer format.
In the field settings, enter extensions separated by commas, such as pdf, jpg, png, docx. Leave out the dot.
Points to check:
- Spelling and case. Write jpg and jpeg separately if you accept both.
- WordPress itself restricts some file types. Gravity Forms explains this on its permitted file types page.
- Executable and script files are blocked on purpose. Do not try to allow them.
If a file has the right extension but still fails, it may have been renamed from another type. WordPress checks the real file content, not just the name.
Is the uploads folder writable?
If the form submits but the entry has no file, Gravity Forms may not be able to write to its folder inside wp-content/uploads, so check folder permissions and free disk space.
Gravity Forms stores uploaded files in its own folder within the WordPress uploads directory. If WordPress cannot write there, the file is lost.
Check these things:
- Folder permissions are usually 755 for directories. See our guide on setting correct file permissions in WordPress.
- The folder owner matches the user your web server runs as. Your host can confirm this.
- Your hosting account has free disk space.
- Media uploads in WordPress itself work. If they fail too, the problem is server-wide.
The WordPress.org guide on changing file permissions explains how permissions work if you need the background.
Is a 413 or 403 error stopping the upload?
A 413 error means the web server rejected the request as too large, and a 403 means a firewall or security rule blocked it, so both need fixes at the server or security layer rather than in Gravity Forms.
The 413 Content Too Large status is explained on MDN's 413 status page. On Nginx it is often controlled by a body size setting, and on Apache by request limits. Your host can raise these.
A 403 usually comes from:
- ModSecurity or another web application firewall.
- A security plugin that flags uploads.
- A CDN firewall, such as Cloudflare rules.
Ask your host to check the firewall log at the exact time of a failed upload. Our guide to fixing the 403 forbidden error covers the usual sources.
Is JavaScript breaking the multi-file uploader?
When multi-file upload is enabled, Gravity Forms uploads files in the background with a script, so a JavaScript error from another plugin or theme can leave the uploader stuck or unresponsive.
Open your browser's developer tools and check the Console tab while you add a file. Red errors point to the script at fault.
Common causes:
- Script optimisation that delays or combines Gravity Forms scripts.
- An outdated jQuery-dependent theme or plugin.
- A second copy of a library loaded by another plugin.
Exclude Gravity Forms scripts from minify, combine and delay features in your cache plugin. If you use AJAX submission too, our guide on Gravity Forms AJAX not working covers related script issues.
Is caching causing upload failures for visitors?
If uploads work when you are logged in but fail for visitors, page caching may be serving an old copy of the form with an expired security token, so exclude the form page from caching.
Gravity Forms uses tokens and unique IDs that change over time. A cached page can hold a stale value that the server later rejects.
Fixes:
- Exclude the form's page from page cache in your caching plugin.
- Exclude it at the CDN level if you use one.
- Purge all caches after changing form settings.
Our guide on clearing cache in WordPress shows how to purge each layer.
Could a plugin or theme conflict be the cause?
Yes, a conflicting plugin or theme can interfere with uploads, so switch to a default theme and disable other plugins on a staging site to find the culprit.
A conflict test is the fastest way to rule this out:
- Create a staging copy of the site.
- Switch to a default theme such as Twenty Twenty-Five.
- Deactivate all plugins except Gravity Forms.
- Test an upload.
- Reactivate plugins one at a time until the upload breaks again.
Our guide on fixing a plugin conflict walks through the process in more detail.
Also make sure Gravity Forms and its add-ons are current. Our guide on updating Gravity Forms covers safe updates.
How do you test that uploads work again?
Submit the form with a small file, a large file near the limit, and a blocked file type, then check that each one behaves as expected and that saved files open from the entry.
A simple test plan:
- Upload a small PDF and confirm it appears in the entry.
- Upload a file just under the maximum size.
- Try an extension you do not allow and confirm the error is clear.
- Test while logged out in a private window.
- Test on a phone, since mobile browsers handle files differently.
Check notification emails too. File links in emails depend on the upload working first, and our guide on Gravity Forms notifications not sending helps if those fail.
When should you contact Gravity Forms support?
Contact support if uploads still fail after you have checked limits, file types, permissions, firewall rules and conflicts, and include your system report and the exact error message.
Gravity Forms includes a system status report under its own Forms menu. Copy it into your ticket along with:
- The form ID and field settings.
- The file size and type that failed.
- Any console or server errors.
- Your host and PHP version.
Clear details help support find the cause much faster. For a security refresher, Gravity Forms also publishes notes on file upload security that are worth reading before you widen allowed types.
Frequently asked questions
How do I increase the Gravity Forms file upload size?
Raise the maximum file size in the File Upload field settings, then make sure your server allows it too. PHP upload_max_filesize and post_max_size must be at least as large, and your host may need to raise web server request limits.
Why does Gravity Forms say the file type is not allowed?
The extension is missing from the field's allowed list, or WordPress blocks that file type for security. Add the extension without a dot, separated by commas, and avoid allowing scripts or executable files.
Where does Gravity Forms store uploaded files?
Uploaded files are saved in a Gravity Forms folder inside the WordPress uploads directory, organised by form. If that folder is not writable, entries may be saved without their attached files.
Why is the Gravity Forms multi-file upload stuck at zero?
The background uploader relies on JavaScript and a separate upload request. A script error, an optimisation plugin delaying scripts, or a firewall blocking the request can all leave it stuck. Check the browser console first.
Can caching break Gravity Forms uploads?
Yes. A cached form page can contain expired tokens, so uploads fail for logged-out visitors while working for admins. Exclude the form page from page and CDN caching and purge caches after making changes.
Sources
- File Upload field Gravity Forms Docs
- Permitted File Types for Uploading Gravity Forms Docs
- File Upload Security Gravity Forms Docs
- php.ini core directives PHP Manual
- 413 Content Too Large MDN Web Docs
- 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.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


