File Upload

A native control to enable file upload features.

The File Upload control is used to upload files like documents, pictures, audio files, videos, and so on. This control provides the features to limit the quantity and size of the files being uploaded.



UI properties

  • Label : Label is the text that is displayed above the text box and helps the user to understand what they are supposed to input in the text box.

  • Properties : These properties help you customize the Label by changing the text size, weight ( Light, Normal, Bold, Extra Bold, X Extra Bold), alignment (Left, Center, Right, Justified) and color of the label.

  • Type : The Type field is automatically generated depending upon the type of control used. In this case, it is an “image_upload” type.

  • Unique Name : A Unique Name is used to uniquely identify a control in the App. Every control that is added on the screen gets an auto-generated Unique Name on the basis of the Label name given to the control.

  • Tooltip: This allows you to add the Tooltip text that would provide a hint to the user for providing input. The Tooltip icon would be visible if you switch on the Show tooltip icon toggle property available below.

  • Description: Is the description that you can add for your controls. The Description would only be visible if you switch on the Show Description toggle property available below.

  • Submit Data : This field lets you determine whether to send the value of the control or not in the Workflow, based on various control states. There are three conditions that could be set for this field.

    1. Always : If this condition is selected, the data in the control will be submitted irrespective of the state of the Upload Control.
    2. Never : If this condition is selected, the data in the Upload Control will never be submitted irrespective of the state of the Upload Control.
    3. No When Hidden : If this condition is selected, the data in the Upload Control will be submitted if the Upload Control is visible and not submitted when the Upload Control is hidden.
  • Required : If you select the required option, the field becomes a mandatory field and the user can not submit without filling it.

  • Read Only : If you select this option, the user will no longer be able to edit this field.

  • Show Tooltip Icon: This allows you to toggle switch ON or OFF to show or hide the tooltip icon where the tooltip text would appear.

  • Show Description: This allows you to toggle switch ON or OFF to show or hide the Description text.

  • Hidden : The hidden option helps you to hide the field from the user. This might help to perform some computation you don’t want the user to see or if you want to show certain fields only when a specific condition is met/not met.

  • Caching : If the caching option is selected and if a LOOKUP formula is applied to this control, the value that the LOOKUP returns will be cached and the user will be able to see this value in the Upload Control even when he accesses the microapp later with no connectivity. This option is required when you want your app to be accessible in offline mode as well and getting the latest data from the sheets always is not critical.

  • Hide Label : This option hides the label of the Upload Control from the view.

  • Trigger dependents: When you Disable Trigger Dependents, it helps you to reduce or optimize the unnecessary evaluation of the dependent control’s formula. For a detailed explanation refer to this article here .
    By default Trigger dependents is enabled. However, in complex apps by switching it off, you would limit the evaluation in the dependent control and in turn ensure quicker response times.


  • Annotation: This option is enabled when you set the File Type as Image. Annotation of image is used to make changes like say marking areas in your image to highlight something and so on. The Annotation is only available with your mobile Apps. If the Annotation option is turned on, you can see that the edit file option is available. So, make the necessary changes or updates and save the file. The file can then be uploaded with the annotations in place.

  • Multiple Files: Toggle switch ON to allow multiple files to be uploaded.

  • No. of Files: Specify the maximum number of files that can be uploaded.

  • Upload from: This property is used to specify where the files would be uploaded. You can upload from the File Manager or from the Camera. This is typically useful when you want to enable the capability to use images captured using the camera when using the Mobile Apps. If you want to specify both as the source then you have the option as well.
    upload from

  • Upload: Is used to specify whether the files are to be uploaded on selection or on submission of the form. This is typically useful when you have multiples files to be uploaded and of varying file sizes. By selecting the option as On Selection for the Update Sheet action or when using the BPM Workflows your files are uploaded to the DHQ S3 bucket In case you select the option as On Submission, then all the files are first uploaded to the DHQ S3 and then the respective sheets or any other sources… This can be time-consuming at times when you have multiple file upload scenarios.

  • File Type: This option lets you select the type of file that you can upload.
    file types

  • Size Per File: This option is used to limit the size of the uploaded files.

  • Whitelist File Type: You can toggle switch ON to further enable you to provide any specific file types. By Enabling this option you would get the next options to provide the valid file types , extensions and magic numbers.

    • Valid File Type: This is the list of file type extensions that you can choose from to restrict users to upload only the mentioned valid file types.

    • Allowed Extensions: This is list of extensions that are allowed in addition to the Valid file types mentioned earlier.

      allowed extensions

    • Allowed Magic Numbers: You can specify the numeric or string constants that represent the file types.



  • Text: Is the text that appears by on upload button for the control.

  • Theme: This property allows you to choose the color of the control. You can either enter a custom hex code value or use one from the available themes in the builder.

  • Layout: This property lets you choose the layout of the File Upload control. There are 3 layouts to choose from as Filled, Outlines, Dashed Outline. The button that prompts you for Uploading files appears in the selected type of layout.

    layout options

  • Close Button color: This option can be used to set the color of the Close button.

  • Font: Are the properties that help you customize the text for the upload button by changing the text size, weight ( Light, Normal, Bold, Extra Bold, X Extra Bold), and color.



This is when there is a change in the value of the respective control namely by clicking another option.

How to use File Upload Control?

Start with selecting the File Upload Control from the Featured section of the Controls Menu.

The control will then appear on the screen in the builder, you can then set all the above properties as per your requirements.

Binding Data

You can use the bind data options available in case you need to bind data.


Default Preview

1 file added

To further understand how to use the File upload control you can have a look at the following video or read the article here to understand better.