Custom form field types

The name of the form field. This title will be used as the label of the field on the frontend.

A note to be displayed alongside the title. This text can be used to provide information to your users about the form field and the expected form of the response.

The default value for the form field. This value will be displayed within the answer field on the form. The user can then override this value. You can use the keyword replacement %globals_user_name% as the default value. The replacement will default the user’s name into this field if they are signed-in to your site.

A placeholder value, a short hint that describes the expected value of the input field. The value entered into this field will be displayed in the input field before the user enters a value.

The input type of the response field. When used, the input field will provide specific interfaces to suit the specified field type. By default, the input type will be set to text.

The width of the text field.

The number of rows for the form field. By default, this value is 1, meaning that the field on the form will be one row. If 2 or more is entered, the text field changes into a multiple line box.

The maximum number of characters that can be entered by the user. If this value is higher than the width, the visible portion scrolls as the user types into the field.

The tab index for the field. This index is referenced when the Tab key is pressed. This function is useful when you have laid out each form field individually on the page contents bodycopy. Consider a scenario where the form field is the first form field on the custom form, but you have put it last on the page contents bodycopy. You can enter the tab index so that when the user presses the Tab key, it will be the last form field to which the cursor goes.

Any additional HTML attributes to be added to the tag used to display the field’s answer field. For example, you may wish to specify a CSS class that defines the form field text formatting.

Each file uploaded through this form field type is stored as an asset. This field allows you to select where in your system, you want these assets stored. For example, you could create a folder under the custom form and store the files in there. If no create location has been set, uploaded files will be stored in the form submission’s data directory. Uploaded files can be downloaded through the Details screen of a submission. This screen can be accessed through the submission logs screen.

Select Yes to attach the file uploaded to the emails that have Include file attachments selected. This option is set on the Email options screen of the Form contents asset. For more information on the Email options screen, refer to the Form contents chapter in this manual.

This field allows you to select the action to be taken if a file of the same name already exists in the upload location you have specified. If no create location is specified, the Overwrite rule is disabled. The available options are:

This rule allows you to limit the file’s size to be uploaded by the user. For example, if you do not want the user to upload a file bigger than 1 MB, select Must be no larger than in the operator field and enter 1 MB in the file size field. When the user tries to submit a file larger than 1 MB, they will receive an error message. The fields that can be set up are as follows:

This rule allows you to limit the type of file uploaded by the user. For example, if you only want to allow them to upload Microsoft Word documents, select Must match one of these extensions in the operator field and enter .doc in the extension list. When the user tries to submit a file that is not a Microsoft Word document, they will receive an error message.

This rule allows you to prevent files from being uploaded should the virus checker detect a virus. The virus checker will detect that a file is infected and not allow it to be uploaded to the system. The fields that can be set up are as follows:

This section shows the values added to the list and allows you to add new ones, delete existing ones, or re-order the list. To add a new value to the list, click within a blank box, enter the value, and select Save. For example, enter NSW, QLD, ACT, VIC, TAS, NT, SA, and WA and select Save. You can enter as many options as you want simultaneously, and there is no limit to the number of options you can add to the list. To delete an option from the list, select the icon.

Select a default value for the list on the custom form. You can only select a default value once you have specified the list options and saved the screen.

Select a comma-separated values (CSV) file from your computer to automatically input the Select form fields' options. This feature is useful for batch uploading several options or importing an existing Select form field’s options. The CSV file can have up to three fields, with the first determining each option’s key, the second determining the value of each option. The third indicates if the option is the default value (1 for yes, 0 for no). An uploaded CSV file will overwrite any current options already inputted.

The height for the list. This height determines the number of rows that are visible at a time. For example, if 3 were entered for the height, three rows will be visible on the custom form.

Whether to allow users to select multiple values from the list. If you select Yes, a box will appear on the custom form where the user can hold down the Shift key or Ctrl key to select multiple values. If you select No, the user can only select one value from the list.

Whether to display an empty option on the list. If you select Yes, by default -- Leave empty -- will appear in the list. You can change this in the empty text field below.

The key for the empty option in the list. By default, this will be empty. This option will only be applied if the Use empty option is Yes.

The text to show for the empty option in the list. By default, this option will say -- Leave empty --. This option will only be applied if the Use empty option is Yes.

Whether users can submit the empty option selection on this field. If this field is disabled, users will be forced to select a valid answer. This option will only be applied if the Use empty option is Yes.

The error text to be displayed when the Allow empty option to be selected? field is disabled, and the user attempts to submit their form, having selected the empty option on this field. By default, this will read:

Please select a valid option.

This rule allows you to validate how many options the user must select from the list. To make a user select two options from the list, select Must select more than this many options in the operator field and enter 2 into the number of options. When the user fills out the custom form, they will receive an error message if they have not selected two options. The fields that are available for this rule are shown:

These fields allow you to specify the rows and columns of the tickbox table. Initially, one blank row and two columns are available for you to add the values. A second blank row or column is added for the following values as you type into a row or column.

This section shows the values added to the list and allows you to add new ones, delete existing ones, or re-order the list. To add a new value to the list, click within a blank box, enter the value, and select Save.

A default value for the list on the custom form. You can only select a default value once you have specified the list’s values in the options field. This value will be selected within the answer field on the form. The user can then override this value.

This rule allows you to validate how many options must be selected from the list. For example, if you want the user to select two options from the list, select Must select more than this many options in the operator field and enter 2 into the number of options. When the user fills out the custom form, they will receive an error message if they have not selected two options. The fields that are available for this rule are shown:

This section allows you to specify which parts of the date and time to show and change their properties. The fields that are available in this section are as follows:

The minimum date and time that the user can enter on the form. You do not need to enter a value into every field. For example, if you want to have a minimum year value of 2000, enter 2000 into the year part of the minimum field. The list in the year field on the form will now start from 2000. By default, no minimum date and time is entered into this field.

The maximum date and time that the user can enter on the form. You do not need to enter a value into every field. For example, if you want to have a maximum year value of 2007, enter 2007 into the year part of the maximum field. The list in the year field on the form will now have a maximum value of 2007. By default, no maximum date and time are entered into this field.

The default date and time. You must enter a full date and time for this to display on the form. For example, if you enter a default date of 20 Dec 2005, it will be shown on the form, but it will not be displayed if you only enter 2005. The user will be able to override any default value that is shown.

The format of the date and time shown wherever the response keyword replacement is used on the thank you bodycopy. This value is in PHP date format. For more information, visit the PHP: date manual.

By default, all countries shown in this list will appear on the form. This field allows you to narrow down the list and only show certain countries, such as Australia, the United States, the United Kingdom, and France. To select multiple countries, hold down the Ctrl key on the keyboard, and left-click on the country.

A default value for the list on the custom form. If you have narrowed down the list of available countries, this list will only show the countries that you have selected. The value selected in this field will appear within the answer field on the form. The user can then override this value.

The height for the list. This height determines the number of rows that are visible at a time. For example, if 3 was entered for the height, three rows will be visible on the custom form, as shown in the figure to the right.

Whether to allow users to select multiple values from the list. If you select Yes, a box will appear on the custom form where the user can hold down the Shift key or Ctrl key to select multiple values. If you select No, the user can only select one value from the list.

the input type of the response field. When using a HTML5 compatible browser, the input field will provide specific interfaces to suit the specified field type.

This section shows the values added to the list and allows you to add new ones, delete existing ones, or re-order the list. To add a new value to the list, click within a blank box, enter the value, and select Save. For example, enter NSW, QLD, ACT, VIC, TAS, NT, SA, and WA and select Save.

Specify the input type of the response field. When using a HTML5 compatible browser, the input field will provide specific interfaces to suit the specified field type.

This rule allows you to specify that the entered number must be or must not be an integer. The fields that are available for this rule:

Select whether you want the user to confirm the password. If you select Yes, two text fields will be shown on the custom form, where the user will have to enter their password twice. Should the two passwords entered not be the same, an error message will appear on the form similar to:

The password field "password" was entered differently on each try.