# File field

**Category:** Field

**Version:** 1.0

**Last Updated:** February 25, 2026

**Author:** Any2Info

***

### Description

The **File** field allows form users to upload a file. What kind can be set by the Forms creator through a property.

***

### General Properties

The **File** field inherits general Field Properties such as ‘Font size’, ‘Font color’ and ‘Icon color’.

***

### Special Properties

The **File** field has a few special properties unique to it. These include:

| Name                                             | Value             | Explanation                                         |
| ------------------------------------------------ | ----------------- | --------------------------------------------------- |
| Pick file                                        | string            | The text displayed when no file has been picked yet |
| Picked file                                      | string            | The text displayed when a file has been picked      |
| Allowed files                                    | List of MimeTypes | A list of MimeTypes that can be freely filled in.   |
| By default this allows all files to be uploaded. |                   |                                                     |
| Maximum size                                     | int (0-25)        | Size in MB that the file is allowed to be           |

***

### Tips & Best Practices

* Be precise when adding Mime Types to the **Allowed Files** property, mime types can get rather specific. And a wrong type means some files might not be allowed for uploading. Use Google or any other search engine to determine what mime type fits your needs the best.
* Set a proper **Maximum Size** based on the use case. Uploading multiple large files will slow down the app.

### Errors

| **Error Message**                                   | **Meaning**                                                  | **Solution**                                                                          |
| --------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| Media size cannot be more than {**maximum size**}MB | The file selected to upload exceeds the **Maximum Size** set | Either make the allowed file size bigger or instruct the user to upload smaller files |
| This type of media is not allowed                   | The file selected to upload is not of an accepted type       | Instruct the user to upload a specific type of file                                   |

***

### Examples

Below is a **File** field with the default properties set. When a user clicks on the field a popup will be shown, allowing the user to select a file to upload.

<figure><img src="https://870194474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_kE41Rl4pOtwKfvvQq%2Fuploads%2FdNojZVUFpAdK7Jho2LgC%2Fimage.png?alt=media&#x26;token=4b7d6079-2f35-41bf-bd0a-d77004e3ad28" alt=""><figcaption></figcaption></figure>

Below is the **File** field when a file has been uploaded.

<figure><img src="https://870194474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_kE41Rl4pOtwKfvvQq%2Fuploads%2F98cUZ06B3XGY4bOFjuNz%2Fimage%201.png?alt=media&#x26;token=21468181-edc8-4aad-af94-c0bf4b2cb7b4" alt=""><figcaption></figcaption></figure>

Downloading and removing a file can be done through the icons on the top right.

***

### Changelog

| **Version** | **Date**          | **Change**                       |
| ----------- | ----------------- | -------------------------------- |
| 1.0         | February 25, 2026 | Initial document & documentation |