# File upload field
The **File upload** field lets users upload files directly through your form.\
It’s perfect for collecting images, documents, designs, or any supporting files customers need to send.
***
### ✅ When to use File upload
Use the **File upload** field when you need customers to share files, such as:
* Order references or screenshots
* Design files or artwork
* Photos for custom products
* Documents or proof files
**Common examples**
* Upload a logo for custom printing
* Attach screenshots for support requests
* Submit design files for approval
***
### ⚙️ How it works
1. Users click **Browse file** or drag files into the upload area
2. Files are uploaded securely when the form is submitted
3. Uploaded files are stored with the form submission
4. You can view or download files from the submission data
***
### 🧩 How to add a File upload field
1. Open your form editor
2. Click **Add element**
3. Select **File Upload**
4. Configure other detail of the field
5. Click **Save**
***
### 🛠️ Field settings
#### Field label
The label tells users what kind of file they should upload.
**Label examples**
* `Attachments`
* `Upload your design`
* `Upload screenshots`
***
#### Button text
Customize the text shown on the upload button.
**Examples**
* `Browse file`
* `Upload file`
* `Choose file`
This helps match your store’s tone and language.
***
#### Placeholder text
The placeholder appears inside the upload area before a file is selected.
**Examples**
* `Choose file or drag here`
* `Drag files here or click to upload`
***
#### Hint text
Use the hint to explain file requirements clearly.
**Example**
```
Supported format: JPG, JPEG, PNG, GIF, SVG
```
This reduces errors and helps users upload the correct files.
***
#### Allowed file types
Control which file formats users can upload.
You can allow:
* Images: `jpg`, `jpeg`, `png`, `gif`, `svg`
* Documents: `pdf`, `doc`, `docx` (if enabled)
**Example**
* Allow only image files for artwork uploads
* Allow PDFs for document submissions
***
#### Set File size limit
Set a maximum file size for uploads (based on your plan).
**Example**
* Limit file size to `10 MB`
* Current plan allows up to `100 MB` per file
This prevents large or unnecessary uploads.
***
#### File size limits by plan
Each pricing plan includes a maximum file size limit for uploads.\
This limit applies to all uploaded files per form submission.
When users upload a file that exceeds the allowed size, the form will block the upload and show an error message.
#### ✅ Example: Allowed upload
**Plan limit:** 200 MB (per file)
* File 1: **20 MB**
* File 2: **30 MB**
⇒ Submission is allowed\
All uploaded files are within the size limit.
#### ❌ Example: Upload blocked
**Plan limit:** 200 MB (per file)
* File 1: **120 MB**
* File 2: **90 MB**
⇒ Submission is blocked\
One or more files exceed the maximum file size allowed by your plan.
***
#### Allow multiple files
Enable this option to let users upload **more than one file**.
**Use cases**
* Upload multiple product images
* Attach several screenshots
* Submit multiple documents at once
***
#### Required field (optional)
When enabled, users must upload a file before submitting the form.
Recommended for
* Design submissions
* Custom order requests
* Support forms that require proof
***
#### 🔀 Conditional display
You can show or hide the File upload field based on user selections.
**Example**
* Show file upload only if user selects **“Custom design”**
* Hide file upload for simple inquiries
***
### 🌟 Best practices
* Clearly explain what file users should upload
* Limit file types to avoid incorrect uploads
* Use hint text to reduce support questions
* Avoid making uploads required unless necessary
***
#### Need More Help?
If you still need assistance, please contact us at [**support@powerfulform.com**](mailto:support@powerfulform.com). Our team will be happy to help you resolve any issues or guide you further.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.powerfulform.com/quick-start/form-field-types/file-upload-field.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.