File upload

This form control is supported on Nintex Mobile in both online and offline modes.

Use the File upload form control to allow users to attach files to a form. You can define the:

  • Types of files users can upload
  • Number of files users can upload
  • The size of files users can upload
Note: 
  • You must set up a default file location to use this form control. The default file location holds uploaded files for later reference by the workflow. If no default file location is set up, then the error message "File upload failed" appears when users attempt to add files to the form.

  • You can arrange up to two of this control on a single row in the form.

Section Setting Description
(unlabeled) Title

Field name displayed on the published form.

 

Customize

Switch toggle to Yes to enable customization of the variable Name of the form control.

 

Name

(This field becomes configurable only when you switch the Customize toggle to Yes.)

Customizes the name of the variable A placeholder that stores changes each time the workflow runs, such as the information entered in a form, or the name of a file. You can also create variables to store information you use in a workflow, such as an email address. for the field. If the name is not customized, the Title will be used as the variable name.

 

Accepted file types

File extensions to allow adding to the form using this control. Select from the following options:

  • Documents: pdf, doc, docx, xls, xlsx, ppt, pptx, txt, rtf
  • Images: jpg, jpeg, png, tiff
  • Compressed files: rar, zip
  • Custom: option to specify your own list of accepted file extensions, such as "rtf,jfif" - separate extensions with commas
  Define custom file types

(Displays when you select Custom for Accepted file types)

Specify the extensions of custom file types to allow. Multiple extensions can be entered using a comma as a separator. For example, pdf, docx, jpg

 

Accepted file types message

The validation text which displays below the field when the user uploads a file which is not selected in the Accepted file types field.

 

Maximum files

Maximum quantity of files to allow adding to the form using this control. Default: 10. Highest valid value: 25.

 

Custom maximum files message

The validation text which displays below the field when the user uploads a quantity of files which exceeds the number defined in the Maximum files field.

 

Maximum size (MB) per file

Maximum size per file to allow adding to the form using this control. Default: 5. Highest valid value: 25.

 

Custom maximum size message

The validation text which displays below the field when the user uploads a file which exceeds the size defined in the Maximum size (MB) per file field.

 

Required

Mandates entry of a value before the form can be submitted.

 

Custom required message

(Displays when you select Yes in Required)

The text which displays below the field when a value is not entered into the field upon change form page or on form submit.

 

Visible

Shows the field on the published form when loaded.

 

Read-only

Displays the field on the published form but does not allow user input.

 

Description

Helper text displayed below the field on the published form.

 

Tooltip

The message which appears when users hover their cursor or touch the information icon beside the File upload control in the form.

  Shrink Reduces the width of the File upload control in a row of other form controls.
  Expand Increases the width of the File upload control in a row of other form controls.
Styling CSS class

Add a CSS class to apply a style to this form control. You can create the CSS class in the CSS code editor in form styles. Enter one class name or multiple class names separated by a space.

For more information, see Add a custom CSS to individual controls.

Note: The CSS Class field is available only if the Custom CSS setting is enabled in Nintex Automation Cloud Form settings.

  Border color

Border color to apply to the field.

To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code.

To revert back to the global style, click Reset to global style.