Skip to main content
Version: 8.1

Perspective - File Upload

Component Palette Icon:


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 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 icon and no text. This icon can be changed using the fileUploadIcon property settings.


Most Properties have binding options. For more information on Bindings, see Types of Bindings in Perspective. This section only documents the Props Category of properties. The other Categories are described on the Perspective Component Properties page.

NameDescriptionProperty Type
maxUploadsThe maximum number of concurrent (simultaneous) uploads to allow. Default is 5.value: integer
supportedFileTypesAn array of string values, indicating what file types are allowed to be uploaded. Example values are "pdf" or "txt".array
fileSizeLimitSpecifies the maximum size of each uploaded file, in megabytes (MB). Default is 10 MB.value: integer
styleSets a style for this component. Full menu of style options is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a style class.object
fileUploadIconDetermines 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 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.
  • object


    See the Perspective - File Upload Scripting page for the full list of scripting functions available for this component.