File Upload Fields

File upload fields allow users to upload files that will be saved along with the form. You can specify the maximum file size and the file extensions that file upload fields will accept.

Settings

Editing a File Upload Field in the Form Designer

  1. Select the field on the canvas, and the options will appear in the right pane.
  2. Under Field label, enter the field label that will appear next to the field on the form.
  3. Under Variable, specify a name for the field variable associated with this field. If you do not specify a variable name, Forms will automatically assign the field one based on its label.
  4. Under Text above field and Text below field, you can enter any additional text that should appear with the field. Click the Insert variable button to include a variable with this text.
  5. Under File options, select Required if users must fill in this field before submitting the form. Select Read-only if users should not be allowed to modify this field.

    6. Note: If a required field is hidden with a field rule, it is no longer required. A required field is only required when it appears on the form.

  6. Under Preview Options select Show uploaded images to allow authenticated users to see a preview if the file is a supported image type. If Include thumbnail preview is selected, choose which Thumbnail Size to be displayed on the form for each image.

    7. Note: The following image types are supported for preview on the form and will save a thumbnail to the repository: "gif", "jpg", "jpeg", "jpe", "jfif", "png", "svg", "bmp", "dib". Additionally, "pdf" files are supported for preview on the form only.

  7. Under Field Size, select the field size that you would like to use.
  8. Under Button label, edit the text of the button displayed.
  9. Under File Size Limits, you can set both the single file maximum size and the total combined file upload size limits.
    • Select Limit single file size and specify the Max Single File Size allowed in MB. The default value is 250 MB.
    • Select Limit total size of files uploaded and specify the Max Upload Size allowed in MB for all files combined. The default value is 25 MB.
  10. To configure advanced options, click the Advanced tab.
    • Under Max File Count specify the maximum number of files that can be uploaded. The default value is 10 files.
    • Under File extensions allowed, specify the three letter file extensions (e.g., .pdf, .jpg, .exe) that the field will accept. If this setting is left blank, any file extensions will be accepted.
    • Under Tooltip, specify the help text that will appear when users hover over the field.
    • Under CSS classes, specify the CSS classes to assign this field. Learn more about using CSS.
  11. To configure field specific rules, click the Rules tab.
  12. Your field changes will be applied to the form automatically.

Note: The labels, tooltip, text above, and text below settings in the form designer support the use of simple HTML markup for formatting purposes.

Editing a File Upload Field in the Classic Form Designer

  1. Select the field on the canvas and click Edit.
  2. Under Field label, enter the field label that will appear next to the field on the form.
  3. Under Variable, specify a name for the field variable associated with this field. If you do not specify a variable name, Forms will automatically assign the field one based on its label.
  4. Under Field options, select from the following additional options:
    • Required if users must fill in this field before submitting the form. If a required field is hidden with a field rule, it is no longer required. A required field is only required when it appears on the form.
    • Read-only if users should not be allowed to modify this field.
    • Show uploaded images to include the image a form user uploads on the form. You can select a small, medium, large, extra large, or custom sized thumbnail of the image. For custom options, the default width is 200 pixels if you do not set a width.

      Note: The following image types are supported for preview on the form and will save a thumbnail to the repository: "gif", "jpg", "jpeg", "jpe", "jfif", "png", "svg", "bmp", "dib". Additionally, "pdf" files are supported for preview on the form only.

      Note: Users cannot view uploaded TIFF images. Users can only view uploaded PDF images on Chrome, Firefox, and Microsoft Edge.

  5. Under Text above field and Text below field, you can enter any additional text that should appear with the field. Click the Insert variable button to include a variable with this text.
  6. Under File extensions allowed, specify the three letter file extensions (e.g., .pdf, .jpg, .exe) that the field will accept. If this setting is left blank, any file extensions will be accepted.
  7. Under Maximum file size, specify the maximum file size, up to 250 megabytes, of each file upload.
  8. Under Button label, enter the text that will appear on the button users will click to upload files.
  9. To configure advanced options, click the Advanced tab.
    • Under Tooltip, specify the help text that will appear when users hover over the field.
    • Under CSS class, specify a CSS class to assign this field. Learn more about using CSS.
  10. When you are finished editing the field settings, click Done. Your changes will be applied to the form automatically.