Summary
The File Upload field allows users to upload a file with their form submission. You may limit which filetypes a user may upload via the properties tab. It is available under the Advanced Fields section within the form editor.
File Upload field as displayed in the Field Library
File Upload field as displayed in the Form editor
Common Settings
This field uses only common field settings for the Appearance and Advanced settings. For a description of each of the common field settings, refer to this article. Below you will find description of specialty settings that are particular to this field.
General Settings
| Settings | Description |
|---|---|
| Allowed file extensions | Enter the allowed file extensions for file uploads. This will limit what type of files a user may upload. See note 1. |
| Enable Multi-File Upload | If checked, this option allows the user to upload multiple files. If unchecked (default state), the upload will accept only a single file. See note 2. |
| Maximum File Size | Use this to specify the maximum size in megabytes allowed for each of the files. |
Notes
1. See this article for important notes on WordPress permitted file types.
2. Once an entry has been submitted using this field, this option will no longer be editable. That is, you cannot switch a file upload field from from single file to multi-file once an entry with a file has been submitted.
Merge Tags
For more information on the use of merge tags, refer to these articles.
Usage
{Field Name:2:modifier}
Modifiers
| Modifiers | Description |
|---|---|
| :download | Denotes that the link created for the download should force the download when accessed. |
Frequently Asked Questions
How do I access uploaded files?
You can access uploaded files from the Entry Detail screen or browse the uploads directory. For more information, refer to this article.
Is there a difference between the File Upload Field and the Post Image field?
Yes. The File Upload field allows you to upload files and link them to the entry without creating a post. Using any Post Fields in a form to collect information without configuring the field will create Untitled draft posts after the form is submitted. Refer to this article about the Post Image field for more information.
What happens to the files if the entry is trashed or deleted?
- When an entry is sent to Trash, the file will be kept.
- When an entry is Deleted Permanently, the file will be deleted.
- When an entry is sent to Spam, the file will be kept.
Where are the files uploaded and stored?
Refer to this article for more information about uploaded files location and storage.