File upload
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
-
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 the 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:
|
|
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. |