> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/quick-start/form-field-types/file-upload-field.md).

# 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

<figure><img src="/files/hkb3VTeM2BREHQHgw1Q1" alt=""><figcaption></figcaption></figure>

2. Files are uploaded securely when the form is submitted

<figure><img src="/files/kH6G7dAGhBkewYC7iVqF" alt=""><figcaption></figcaption></figure>

3. Uploaded files are stored with the form submission
4. You can view or download files from the submission data

<figure><img src="/files/WYMAF5ZA8solcN81J51d" alt=""><figcaption></figcaption></figure>

***

### 🧩 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**

<figure><img src="/files/42rNOQXj4D7kgMv1xnfo" alt=""><figcaption></figcaption></figure>

***

### 🛠️ Field settings

#### Field label

The label tells users what kind of file they should upload.

**Label examples**

* `Attachments`
* `Upload your design`
* `Upload screenshots`

<figure><img src="/files/3D7h0cFdEwRDb3kw30wV" alt=""><figcaption></figcaption></figure>

***

#### 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)

<figure><img src="/files/UqV9hO8XPlaVi4FqTmXS" alt=""><figcaption></figcaption></figure>

**Example**

* Allow only image files for artwork uploads
* Allow PDFs for document submissions

***

#### 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 in Free plan:** 2MB (per submission)

* File 1: 1 **MB**&#x20;
* File 2: 1 **MB**&#x20;

⇒ Submission is allowed\
All uploaded files are within the size limit.

#### ❌ Example: Upload blocked

**Plan limit in free plan:** 2 MB (per submission)

* File 1: **2 MB**&#x20;
* File 2: **1 MB**&#x20;

⇒ Submission with these files 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  <contact@globo.io>. Our team will be happy to help you resolve any issues or guide you further.