---
title: "Perspective - File Upload"
description: "The File Upload component allows users to upload files to the Gateway or other locations from a Perspective session using a script action on the onFileReceived component event."
---

# Perspective - File Upload

> The File Upload component allows users to upload files to the Gateway or other locations from a Perspective session using a script action on the onFileReceived component event.

![Perspective File Upload Component Icon](perspective-file-upload-component-icon.png)

**Component Palette Icon**:  

![](img2.png)

## Description

The File Upload component allows users to upload files to the Gateway or other locations from a Perspective session using a script action on the onFileReceived component event. For an example, see [Download and Upload Files](appendix\components\perspective-components\perspective-input-palette\perspective-file-upload\download-and-upload-files\download-and-upload-files.md) page. 

The component has different appearances based on its width. When initially dragged onto your View, a Browse button will be visible and paired with "Drag files here" text. At smaller widths, the component defaults to a simple cloud ![](img3.png) icon and no text. This icon can be changed using the fileUploadIcon property settings.

## Properties

Most Properties have binding options. For more information on Bindings, see [Types of Bindings in Perspective](ignition-modules/perspective/working-with-perspective-components/bindings-in-perspective/bindings-in-perspective.md).
This section only documents the Props Category of properties. The other Categories are described on the [Perspective Component Properties](ignition-modules/perspective/working-with-perspective-components/perspective-component-properties.md) page.

| Name               | Description    | Property Type  |
| ------------------ | ---------------- | -------------- |
| enabled        |  Determines whether or not the component is enabled. Note that the color and style enabled/disabled properties are dependent on this property state. Default is true.  |value: boolean |
| maxUploads         | The maximum number of concurrent (simultaneous) uploads to allow. Default is 5.    | value: integer |
| supportedFileTypes | An array of string values, indicating what file types are allowed to be uploaded. Example values are `pdf` or `txt`.    | array          |
| fileSizeLimit      | Specifies the maximum size of each uploaded file, in megabytes (MB). Default is 10 MB. Note that values over 20 MB are not allowed, unless the max-file-size property in the [web.xml](appendix\reference-pages\web-xml-file-reference\web-xml-file-reference.md) configuration file is set to a higher limit, as the max-file-size property overrides this setting.   | value: integer |
| fileUploadIcon     | Determines the icon used when the File Upload component is small.**path**: Shorthand path to the icon source. Format is library/iconName. The [materials icon library](https://fonts.google.com/icons?selected=Material+Icons) is a the primary source for icons. Value is string.**color**: Color of the placeholder icon, if it exists. Can be chosen from a color wheel, a color palette, or entered as an RGB or HSL value. See [Color Selector](../../../../reference-pages/color-selector-reference/color-selector-reference.mdx) for more information. **enabled**:  Color of the icon when the parent enabled property is set to true.**disabled**:  Color of the icon when the parent enabled property is set to false.**style**: Sets a style for the icon.  | object  |
| style              | Sets a style for this component. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).**enabled**:  Style of the component when the parent enabled property is set to true.**disabled**:  Style of the component when the parent enabled property is set to false. | object         |

## Scripting
See the [Perspective - File Upload Scripting](appendix\components\perspective-components\perspective-input-palette\perspective-file-upload\perspective-file-upload-scripting\perspective-file-upload-scripting.md) page for the full list of scripting functions available for this component.