Upload File
The Upload File component allows users to upload one or more files as part of a form submission. It is commonly used for collecting documents, images, media files, or other supporting materials.
How It Works
The Upload File component displays a file upload area where users can click to select a file or drag and drop files from their device.
On desktop devices, users can drag files directly into the upload area. On mobile devices, tapping the upload area opens the device’s file picker or camera, depending on the file type and device capabilities.
The component supports the following file types by default:
- Images: PNG, JPEG, JPG
- Documents: DOC, DOCX, PDF, CSV, XLS, XLSX
- Audio: MP3, WAV
- 3D Models: PLY, STL, OBJ
- Video: MOV, MP4
You can customize the label, prompt text, required state, allowed file extensions, and other behaviors to match your form requirements.
Properties
| Property | Description |
|---|---|
| Label | Text displayed above the upload field to identify its purpose. |
| Hide Label | Hides the label visually while keeping it accessible to screen readers. |
| Disabled | Displays the upload field but prevents users from selecting or uploading files. |
| Prompt | Instructional text shown inside the upload area to guide users on what to upload. |
| Help Text | PAdditional guidance or clarification displayed below the field. |
| Make Required | Requires the user to upload at least one file before submitting the form. |
| Add CSS Class | Applies custom CSS classes for styling and layout customization. |
| Display Component in Navigation | Includes the upload field in form navigation or summary views (if enabled). |
| Override File Name | Replaces the original file name with a custom name when saving uploaded files. |
| Keep original file name | Preserves the file’s original name as uploaded by the user. |
| Allowed File Extensions | Restricts uploads to specific file types (for example, PDF or JPG). |
| Unique Name | A required identifier that must be unique within the form. Used in variables, email templates, webhooks, and integrations. |
| Variable Name (for Printable Template) | A variable identifier that can be copied to collect information in printable PDF or Word forms. |
Using Upload File Values in Other Parts of the Form
You can reference the uploaded file elsewhere in the form (e.g., success pages, PDF templates, notification emails) using the component’s Unique Name as a variable.