# Media field

**Category:** Field

**Version:** 1.0

**Last Updated:** February 25, 2026

**Author:** Any2Info

***

### Description

The Media field allows the user of a form to upload a pre-defined set of media files. Including pictures, videos and audio

***

### General Properties

The Media field inherits general Field Properties such as ‘Font size’, ‘Font color’ and ‘Border color’.

***

### Special Properties

The Media field has multiple special properties. First those in the **Image zooming** category:

| Name         | Value      | Explanation                                                                                                                                                 |
| ------------ | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enabled      | True/False | Indicating whether or not image zooming is enabled                                                                                                          |
| Default zoom | 100 - 5000 | 100 means 1 to 1 the dimensions of the given Media value. Any additional value means 1% bigger. 5000 would be 50x bigger than the original Media dimensions |
| Max zoom     | 100 - 5000 | 100 means 1 to 1 the dimensions of the given Media value. Any additional value means 1% bigger. 5000 would be 50x bigger than the original Media dimensions |

**Media** category:

| Name            | Value               | Explanation                                              |
| --------------- | ------------------- | -------------------------------------------------------- |
| Allow photo     | True/False          | Indicating whether or not photo uploading is enabled     |
| Allow video     | True/False          | Indicating whether or not video uploading is enabled     |
| Allow audio     | True/False          | Indicating whether or not audio uploading is enabled     |
| Maximum size    | 0-500               | Size of the allowed files in MB                          |
| Compress width  | 512 - 2147483647    | The value to compress the width to                       |
| Compress height | 512 - 2147483647    | The value to compress the height to                      |
| Ratio           | 0 x 0 - 1000 x 1000 | The ratio, based on the original dimensions, to maintain |

***

### Allowed files per type

The following files are allowed if Photos are allowed:

| Name | Extension |
| ---- | --------- |
| PNG  | .png      |
| JPEG | .jpeg     |
| JPG  | .jpg      |

The following files are allowed if Videos are allowed

| Name | Extension |
| ---- | --------- |
| MP4  | .mp4      |

The following files are allowed if Audio files are allowed

| Name        | Extension |
| ----------- | --------- |
| MPEG        | .mp3      |
| WAV         | .wav      |
| AAC         | .aac      |
| ADTS        | .adts     |
| MP4 (Audio) | .mp4      |

***

### Tips & Best Practices

* If the **Allow Photo** is set to false, you may also disable **Image Zooming**, as it has no effect.
* Set a proper **Maximum Size** based on the use case. Uploading multiple large files will slow down the app.
* The point above is also relevant for the **compress width/height**.

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

A default **Media** field will look as such:

<figure><img src="https://870194474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_kE41Rl4pOtwKfvvQq%2Fuploads%2Fo6OdmUqa9r09FXTH9BdR%2Fimage.png?alt=media&#x26;token=dfedf39e-b9f2-4c19-8c8e-9392e1a6758d" alt=""><figcaption></figcaption></figure>

A user is allowed to upload Images, Videos and Audio files. Indicated by the 3 Icons shown. When a user clicks on the field they an upload a file, where the extensions depend on the “**Allow**” properties.

When having uploaded an **Image** the field will display it.

<div align="left"><figure><img src="https://870194474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_kE41Rl4pOtwKfvvQq%2Fuploads%2FNdgwg8NOFz00Hc6dI8TW%2Fimage%201.png?alt=media&#x26;token=26c598cf-e539-4b0a-af9e-ef67d7aea4b6" alt="" width="188"><figcaption></figcaption></figure></div>

The same goes for **Videos** and **Audio**, these also have the option to view/listen to the uploaded file. Depending on what type of file it is.

If the uploaded files ratio is off, a crop image popup appears. Allowing the user to crop the given media file down to an accepted size.

<div align="left"><figure><img src="https://870194474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_kE41Rl4pOtwKfvvQq%2Fuploads%2F2QhuLayedpK20u3gdnUg%2Fimage%202.png?alt=media&#x26;token=19c1856b-b579-44b2-be0c-3ed7338e5e64" alt="" width="271"><figcaption></figcaption></figure></div>

Deleting a value can be done through the trash can in the top right of the field.

***

### Changelog

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