File Upload
Purpose
The File Upload field type lets users attach one or more files in a form submission. You can control file count, allowed file types, and file size limits before files are accepted.
When to use
- Job applications, onboarding forms, support forms, or verification workflows.
- Any workflow where users must provide documents or images with their submission.
Key settings
- Field — Field Type: file_upload, Field Title.
- Upload limits — Max Upload File Count, Max Upload File Size.
- File type control — Accepted File Types.
- Validation — Required and upload error messaging.
- Edit behavior — In edit scenarios, optional behavior for existing files (where enabled).
Top features to configure
- Max upload file count — Control how many files one user can submit at once.
- Max upload file size — Prevent oversized uploads and failed submissions.
- Accepted file types — Restrict uploads to formats your workflow supports.
- Required upload — Force at least one attachment for mandatory document flows.
- Upload error messages — Customize user-facing messages so users know exactly what to fix.
Validation behavior
- File count, file size, and file extension checks run before submission succeeds.
- Required enforces at least one uploaded file.
- Unsupported file types are blocked based on your allowed extensions list.
Common mistakes
- Allowing file types that your workflow cannot process.
- Setting file-size limits too low for real-world uploads.
- Forgetting to test uploads on mobile networks and slower connections.
Verify it works
- Upload a valid file and submit the form.
- Test an invalid file type and confirm it is rejected.
- Test an oversized file and confirm the expected error appears.
- Check Entries and notifications to confirm file data is saved correctly.
What's Next
- Use Hidden field to pass context with uploaded files.
- Review Form settings for notification and submission behavior.
- Check FAQ for common upload troubleshooting.