Guide: Managing uploaded files and documents in Gravity Forms

Gravity Forms file uploads: A comprehensive guide (manage your files with ease!)

Written by Casey Burridge

Last updated:

Categories Gravity Forms


The Gravity Forms File Upload field allows users to upload images, videos, documents, and other files as part of their form submissions.

In this comprehensive guide, we’re going to show you how to accept file submissions through your forms, how to style the file upload button, what to do with uploaded files when they’re submitted, and much more.

Let’s get started!

How to upload files and documents to a form

You can upload files to a form using the Gravity Forms “File Upload” field. This is an advanced field type that you can add to your forms from inside the visual form editor. Let’s take a look at this powerful form field in more detail.

The Gravity Forms File Upload field

You can find the “File Upload” field in the “Advanced” panel in the Gravity Forms editor. To add this field to your form, simply drag and drop it onto the canvas.

The 'File Upload' field in the Gravity Forms editor

After adding the field to your form, you’ll need to configure a few settings. First is the “Allowed file extensions” setting. Here, you can set the type of files that users are allowed to upload in their submission.

For example, if you only want users to be able to upload PDF and docx files, you would add those extensions to the box separated by commas (e.g.: pdf, docx).

An input box labeled 'Allowed file extensions'

If you leave this box blank, users will be able to upload any type of file. From a security point of view, it’s best to specify the allowed file types here.

Next, you can specify the maximum allowed file size. The maximum size will default to the maximum upload size allowed on your server (usually 256MB). However, if you don’t want users to upload large files, you can specify a limit here (e.g. 2MB).

An input box labeled 'Maximum File Upload Size'

Here’s what the default Gravity Forms File Upload field looks like on the front end:

A button labeled 'Choose File' allowing users to select a file to upload to a Gravity Form

So, what if you want users to be able to upload more than one file with their submission? Luckily, that’s also possible using the File Upload field!

Upload multiple files to a Gravity Form

In order to upload multiple files through a “File Upload” field, you’ll need to enable the “Multi-File Upload” functionality in the field settings.

A checkbox labeled 'Enable Multi-File Upload'

After enabling multi-file upload, you can also set the maximum number of files that users are allowed to upload with each submission.

How to style the file upload button

Let’s be honest, the default look of the File Upload field leaves much to be desired. Luckily, there are several ways to improve its look and feel, without needing to mess a round with custom code!

As a reminder here’s what the field looks like by default:

The default look of the file upload field: a gray button with dark text,

The easiest way to improve the look of this field is to change your form’s default theme to “Orbital”. If you’re not familiar with form themes, they were introduced in Gravity Forms 2.7 and allow you to update your form’s styles without needing to write custom code.

Here’s what the File Upload field looks like when using the “Orbital” theme:

Orbital themed file upload field

There’s another way to change the look and feel of the File Upload field that doesn’t involve having to tinker with the code. If you simply enable the multi-file upload feature, the look of the field will change completely.

A box where users can drop files for upload

If you still only want users to be able to upload a single file, just set the “Maximum Number of Files” to 1.

The 'Enable Multi-File Upload' box is checked and the 'Maximum Number of Files is set to "1".

And finally, the third way to change the look of the File Upload field is by combining these two approaches together! Here’s what the field looks like when setting the form theme to “Orbital” and enabling the multi-file upload option: 

A box allowing users to drag and drop files for upload, a blue button that read 'Select files' and an icon.

How to modify the Gravity Forms file upload location

Gravity Forms hides the true location of uploaded files for security purposes. If you want to view the URL for a specific file, you can follow this helpful guide.

Changing the upload location using a filter

If you want finer control over the upload location of files uploaded through your form, you can use the following filter:


For more information about using this filter to change the file upload path, check out this guide from the Gravity Forms documentation.

Upload files to the media library

If you want to change the location of uploaded files using a less technical solution, then consider using Gravity Forms Media Library by Gravity Wiz.

Gravity Forms Media Library is a plugin that allows you to automatically import uploaded files to the WordPress media library when your form is submitted.

The Gravity Forms Media Library plugin by Gravity Wiz

Create a repository of files on your website

Changing the file upload path or adding uploaded files to your media library is helpful, but this doesn’t give you full control over your uploaded files. 

If you’re looking for a way to categorize, tag, edit, and share files on your website, then why not build a document library using GravityView? Using GravityView’s flexible drag-and-drop builder, you can display files in a searchable table or list on the front-end of your site!

A document library built using GravityView

Gravity Forms file upload to external storage

You may want to back up all uploaded files to an external storage location, such as Dropbox, Google Drive, or another server running SFTP. Here are several ways to do this:

Export entries using GravityExport

GravityExport is an add-on for Gravity Forms that allows you to export entries to CSV, XLSX (Excel), or PDF. The add-on also allows you to save entries and uploaded files to Dropbox, an external server running SFTP, or your local storage.

Official Gravity Forms Dropbox add-on

You can send all files uploaded through your form directly to your Dropbox using the official Gravity Forms Dropbox add-on

The Add-On also includes a “Dropbox” field, which you can add to a form. This allows users to upload files from their own Dropbox as part of their submission.

Sending files to Google Drive

If you need a way to send uploaded files to your Google Drive, you can use the Gravity Forms + Google Drive Integration Premium add-on. This is not a Gravity Forms Certified add-on, so be sure to check when it was last updated before installing it on your site.

More automations with Zapier

If you need a way to send uploaded files to a different storage location, you can set up an automation using Zapier. In fact, there is an official Zapier add-on for Gravity Forms that makes it easy to create complex automations for uploading files to different locations!

The Zapier connection for Gravity Forms and Google Drive

Attaching file uploads to notifications

Gravity Forms includes an option that allows you to attach uploaded files to email notifications. 

To create a new email notification, go to the form settings, click “Notifications” and then “Add New”. After configuring the notification, check the box that says “Attach uploaded fields to notification”.

A checkbox labeled 'Attach uploaded fields to notification'

When the notification triggers, uploaded files will be added as attachments.

Gravity Forms file upload errors

You may occasionally encounter errors when using the Gravity Forms File Upload field. Here are some common errors and how to fix them.

Gravity Forms enable multi file upload not working?

If you find that you can’t enable the multi-file upload option on your form’s File Upload field, it may be because your form has already received submissions.

If your form has already received submissions, the multi-file upload option will be disabled. The reason for this is that the multi-file upload field stores files differently to the regular file upload field.

If you delete your form’s existing entries, this setting will become available again. Alternatively, you could add a new field to your form and set the existing field to “Administrative”.

File upload not working on mobile devices

If you’re unable to upload files on a mobile device, try enabling HTML5 mode for better mobile compatibility. You can do this by hovering over “Forms” and clicking “Settings”. You’ll find the option towards the bottom of the page.

A toggle allowing you to enable HTML5 output

File upload failed

If you’re encountering any of the following errors

  • FAILED (Temporary file could not be moved)
  • FAILED (upload folder could not be created) 
  • Upload folder is not writable

There are several things you can do to try and rectify the issue:

  • Check folder permissions
  • Check folder ownership
  • Ensure file isn’t potentially dangerous

For more information on troubleshooting file upload issues, read this article on the Gravity Forms docs site. 

Displaying files uploaded to Gravity Forms

Using GravityView, you can display files uploaded through your forms using preset layouts! GravityView includes a drag-and-drop builder, making it easy to build powerful web applications without any code.

Here are some example:

Creating people profiles

If you use Gravity Forms to register new users on your site, you can use GravityView to create and display people profiles. If users upload profiles pictures or other images as part of the registration process, you can easily display those on the front end.

A user profile built with GravityView that displays Gravity Forms data

Managing job applications

If you’re using Gravity Forms for job application submissions, you can use GravityView to build an application management system. GravityView’s powerful, built-in entry approval functionality makes it easy to approve or deny applications that you receive.

GravityView also allows you to manage uploaded resumes and other documents.

An application review system built using GravityView

Managing important documents 

Using GravityView’s builder, you can also create powerful front-end interfaces for managing submitted files. To see an example of how to create a document library using Gravity Forms and GravityView, read How to Create a WordPress Document Library Using GravityView DataTables.

A document library built with GravityView

Building an online library

Use the Gravity Forms File Upload field to collect resources that you can display in an online library for your school, academic institution, or private organizations!

An online library of books built with Gravity forms and GravityView

Managing uploaded files in Gravity Forms

That concludes our comprehensive guide on managing uploaded files in Gravity Forms! The Gravity Forms File Upload field is a powerful field enabling users to submit files and documents as part of their submission.

If you found this post helpful, subscribe to our newsletter below for more Gravity Forms tips, guides, and tutorials!

Helpful tips right in your inbox.

Subscribe to our weekly newsletter for tips, special offers, and more!

Helpful tips right in your inbox.

Subscribe to our weekly newsletter for tips, special offers, and more!