HomeGuidesAPILog In

File Selection

The File Selection question allows users to add various documents, images, text, and audio files to a form. These can be directly uploaded by the user or searched for from the Content Library.


This question can be used to gather files for users in existing workflow steps, insert the uploaded files into a document output using placeholders, add the files to the content library for future use, and more.


The offline app does not support file upload

Only images can be uploaded in the offline app

Question Properties

PropertyDescription / Examples
MandatoryWhether the field is mandatory.
MultipleEnables uploading multiple attachments at a time, by selecting the files or using drag and drop. When uploading, the multi-file upload dialog is presented as a modal, and each file shows name, status and progress information, as well as the option to remove.
ViewableEnables supported file types to be viewed without download. Default is on.
Content TypeSelect the type of content that will be uploaded or selected from a drop-down list. Options are listed below: Document Fragment - Only accepts Doc and Docx files Image - Only accepts image files Text - Accepts text, very similar to a text field Attachment - Accepts all file types Audio - Only accepts audio files
Display TypeSelect if the display and functionality of the question. The options will depend on the display type selected: Upload File – Enable uploading of files in Produce. Upload Image – Enable uploading of images in Produce. Camera Front – Opens the front camera on an iOS or Android device, but displays a file selection option on a computer. Camera Back – Opens the back camera on an iOS or Android device, but displays a file selection option on a computer. Search - The content library can be searched for existing items to use Search or Upload - Allows the option of Search or Upload
Image ResolutionChoose a setting from the drop-down menu to indicate the resolution of the images that have been uploaded. The default option is "Actual," which means the image will remain unchanged. The other options are: Small (320×240) Medium (640×480) Large (1632×1224) Actual Size, which is the original size of the image as captured by the camera or uploaded without any alterations. Adjusting the image resolution enables you to manage the file size effectively, which can be particularly helpful when attaching the image to an email or using it with a third-party software.
OrientationPrompts the user to change the way you take and display the photo when using the camera on mobile devices. This can be Any, Portrait, or Landscape. This property can only be configured if Camera Front or Camera Back Display type has been selected. An animated prompt displays when the device is using the opposite orientation.
Button TextSpecifies the button name for uploading content on web forms. If left blank, the default text will be used. Note: This text will still be used for offline apps except for image and audio file types.
Take Photo or Record Video Button TextSpecifies the button name for uploading images or audio files on the offline apps. If left blank, the default text will be used depending on the upload type.
Attachment NameGives the file an assigned name upon generation. Note: The Attachment Name field accepts question references. This can be used to make your attachments name more descriptive.
Allow Add To Content LibraryAllows the items which are uploaded to be inserted into the content library.
Valid ExtensionsA comma-separated list of valid file type extensions. For example, if you enter .pdf, .jpg, .docx, then only PDFs, jpg and Word documents can be uploaded as the attachment. If no value is entered, all file extension types will be allowed. Visible if 'Upload' is selected. Note: The "Valid Extensions" field accepts a comma-separated list of values that define what type of documents can be uploaded to Produce. For example, if you enter: .pdf, .doc, .docx, then only PDFs and Word documents can be uploaded as the attachment.
Max FilesSpecifies the maximum number of files that can be attached. Note: Default is 0, or no limit set.
File Size Limit (MB)Maximum upload size in whole numbers of MB. The smallest upload limit is 1MB. Note: This is applied to each individual file when the Multiple Attachments option is enabled. Also, the default is 0, or no limit set.
Content FolderIf Allow Add To Content Library is selected, a content library folder will need to be selected to insert the file into.
Restrict By FolderSpecify a folder in the content library to search.
Allow EditAllows users to edit existing text files inside the content library. Visible if Content Type Text, Display Type Search or Upload and Search is selected.


If Multiple attachments has been enabled, the answer types changes to [File Count] and [File Name]. The data can be accessed by using the Zip action.

Answer Properties

Answer properties change depending on the Content Type property selected for the question. Document fragment, Text, and Audio content types don't have any additional answer properties.

Attachment type


Image Type

Max HeightThe value assigned to this property is the maximum height.
Max WidthThe value assigned to this property is the maximum width.
UnitsThis property provides a range of units.
Stretch to FitChecking the ‘Stretch to Fit’ checkbox stretches the image to fit the max height and max width value.

Note: If ‘Max Height’ and ‘Max Width’ values are greater than the original size of the image then the resulting image will take the original image’s size dimensions unless ‘Stretch to Fit’ is ticked.

However, If ‘Max Height’ and ‘Max Width’ values are less than the original size of the image, the resulting image will accept the given size dimensions, even if the stretch to fit checkbox is not ticked. Thus the resulting image size will get reduced from its original size.
Alternative TextThe value provided to this property will appear as an alternative text in the generated document.

Referencing Uploaded File Contents

Actions and data sources can Referencethe contents of a file uploaded to a form. To reference the file contents, add the following to the end of a reference to the file upload question:


For example, if your upload question is q1, the question reference will be [q1.hex] or [q1.base64].

To check the name or size of the uploaded document, use the following:



When there has been no file uploaded to the question, then the result is a blank string.

Question Types

Camera Back

Camera Front


Upload File

Upload Image

Upload or Search