Form field: upload

Modified on Thu, 20 Jul, 2023 at 10:19 AM

The icon for elements of type Upload.

Functionality

Form elements of type Upload add an upload element to the form for uploading files that will be send together with the form data when the form is submitted. You can also add a label in the properties panel label of the FORMCYCLE Designer.

Properties

Overview of the standard properties

This section describes only those properties that are different from the standard.

Style

Additional base properties for upload elements, such as the image preview.

When the image preview is enabled and the user select an image, a thumbnail of that image is shown. When the user select a file other than an image, a general icon is shown.

Name	Description
Image preview	When checked, displays a thumbnail of the file the user selected. For image files this is a scaled down version of that image. For other files, a file icon is shown.
7.0.11+ Automatic Upload	When enabled, selected files are uploaded automatically in the background. This can help to reduce the time it takes to submit the form.

Constraints

The constraints let you restrict the allowed file types and the maximum file size.

Name	Description
Max. size	Maximum size for the uploaded file in kilobytes.
Extensions	Comma separated list of allowed file extensions the user may upload. Only files with the given extensions may be uploaded by users. File extenstions may start with or without a dot. For example pdf or .pdf will restrict uploads to PDF files.

Label

You can also specify a file name to be used instead of the original file name.

Name	Description
File name	When no name is specified, the uploaded file will be saved with its original name. Otherwise, this name is used for saving the file on the server.
7.0.11+ Compress images	When enable, uploaded images are scaled and converted to the target format. The file that was originally uploaded is discarded, only the compressed image is saved. Should the compression fail unexpectedly (such as when the server does not support the file format), the original file is saved instead.
Max. width	The maximum width of the compressed image. The image is scaled by an amount such that this width is not exceeded. If you enter a value of 0, no restriction applies.
Max. height	The maximum height of the compressed image. The image is scaled by an amount such that this height is not exceeded. If you enter a value of 0, no restriction applies.
Format	Target format of the image. When you select automatic, the system attempts to preserve the original format of the uploaded image.
As PDF	When enabled, a PDF with the images is created, assuming a resolution of 150 dpi for the page size of the PDF.