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

![](img1.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  |
| ------------------ | ---------------- | -------------- |
| 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.   | value: integer |
| 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). | object         |
| 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 is a the primary source for icons, see https://fonts.google.com/icons?selected=Material+Icons. Value is string.**color**: Color of the placeholder icon, if it exists. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](../../../../reference-pages/color-selector-reference/color-selector-reference.mdx). | 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.