1. Home
  2. Forms
  3. Form Editor
  4. Form Editor: Field Properties

Form Editor: Field Properties

The Form Editor Field Properties allow you to customize individual fields to better suit your specific needs, and improve the efficiency and clarity of your forms.

Common Field Properties

After dragging a field on to the Form Editor layout area you will see several different options within the field. The Field Title and Field Help Text properties can be set directly from the form layout area.

Common Field Properties

Field Title appears above the field. It lets the user know what information should be in the field, for example ‘First Name’ or ‘Date of purchase’. You can edit this value directly; simply click on the text to edit it. Or, you may also edit this in the Field Properties (in the General section of the Basic Tab). The default title will be the name of the component, e.g., ‘Text Field’, or ‘Date Field’.

Note: It’s possible to leave the field title blank. However, the field will have no title in your views unless you override the title in the field settings in the view editor.

Help Text appears under the field. It allows you to add any necessary additional information, e.g., directions, clarification, or an example of the correct format (“Enter employee ID in the following format ‘A – 1234’). You can edit this value directly; simply click on the text to edit it. Or, you may also edit this in the Field Properties (in the General section of the Basic Tab). There is no default help text and it will be blank unless you edit it.

Field Icons

https://vhu.937.myftpupload.com/wp-content/uploads/2018/04/Required-Star-2.pngClick on this icon to set the field as ‘Required’, meaning the record cannot be saved without a value filled in.
https://vhu.937.myftpupload.com/wp-content/uploads/2018/04/Duplicate-Icon.pngClick on this icon to create a duplicate copy of the current field. The new field will appear below the current field in the same column container.
This image has an empty alt attribute; its file name is info-smaller-1.pngClick on this icon for more in-depth field properties, displayed in a right-side properties panel.
https://vhu.937.myftpupload.com/wp-content/uploads/2018/04/ic_delete_black_36.pngClick on this icon to delete the field from the form.

Field Properties

All field properties can be found by clicking on a the Properties icon within the field and going to the properties panel on the right side of the screen.

This image has an empty alt attribute; its file name is info-smaller-1.pngClick on this icon in the field to open the field properties.

For most fields, there are three tabs in the properties panel: Basic, Advanced, and Language. However, several fields also have a tab called Options with additional field specific properties.

Basic Tab

Most fields will have two to three sections in the Basic Tab. The most common by far are General, Validation, and Format.

The State and Country fields have a section called Selection which simply lets you choose whether or not to allow multiple selections.

The Table field has a section called Table Properties where you can specify properties for the table view.

Form Editor Basic Field Properties

General

The General section has a set of properties that exist on nearly all components.

Form Editor General Field Properties
  • Display Name is the Field Title.
  • Default Value is the initial value to populate this field with each time a new record is created using this form.
  • Field Help Text.
  • Short Code is a short alias or nickname for the field. It is used when referring to the field in formulas. It can be edited by clicking on the pencil icon.
  • Field Value Required. After you make a field required, you may set the message to show users when the field is left empty.

The Radio Button and Checkbox fields have an additional property which determines how the options will display.

General Orientation

The Drive Picker and Attachment fields have a Button Name property, instead of a Default Value property.

General Button Name

Attachment Field

The Attachment field has a few extra general properties.

General Attachment Field

After choosing the Card Layout you can choose the Card Size.

Preview allows users to view an attached image in window overlay by clicking on it.

Validation

The Validation properties let you choose conditions that determine whether or not the input data is valid for the field. These properties are often unique to the field type. However, there are a few common properties.

Form Editor Field Properties Validation
Number field Validation.

Many fields have three validation properties in common.

  • Minimum and Maximum Value OR Minimum and Maximum Allowed Characters allows you to set the minimum and maximum values/characters for the field, and also lets you write a custom message for invalid values, or an improper length.
  • Is a Unique Value makes it so you cannot have multiple records with the same value in this field. For example, if this is turned on for a Number field, and I put the number ‘1’ in this field and save the record, when I go to create a new record I cannot have ‘1’ in this field. If you try to save the record, this message will pop up:
Unique Value

Text Field

In addition to the three properties above, Text fields have another validation property called Pattern.

Validation Text Field Regex

Pattern allows you to set a required format for your text fields using Regular Expressions. You can learn more about Regular Expressions here. You may also use regex101 to help you build and test expressions before using them on your forms.

Date Field

Validation Date Field

When choosing an Earliest or Latest Allowed Date, you must select either an Exact Date or Relative Date.

  • Relative Date is relative to the day the record is being created.
Validation Date Relative
Earliest Allowed Date is one week in the past, relative to the date the record is being created on.

Allow Typed in Dates gives users the ability to type in a date. By default, the user can only choose a date from a pop-up calendar.

A couple accepted typed formats:

  • mm/dd/yyyy
  • ‘June 6 2021’ or ‘6 June 2021’
This image has an empty alt attribute; its file name is calendaricon.pngWith Allow Typed in Dates turned on, users may still select from a pop-up calendar by selecting this icon in the field.

Is a Unique Value.

Time Field

Validation Time Field

Similar to a Date field, you may select an Earliest and Latest Time, and also customize the error message.

Phone Field

Validation Phone Field

Default Country Code will determine the default country code for the field when creating a new record. The country code can still be changed by the user.

User Default Country Code only disables the ability for the user to change the country code.

Checkbox Field

Checkbox Field Validation

Minimum / Maximum Allowed Selection determines the selection constraints for the checkbox field options. You may also add a custom message to show users when the constraints aren’t met.

Attachment Field

Note: The attachment field validation properties are found in a separate tab titled Validations.
Validation Attachment Field

Max File Size determines the file size limit. You may then customize the message users will see when they exceed the limitation.

Allow Multiple Attachments to allow more than one file attachment to be uploaded to this Attachment field. Only a single file can be uploaded to this field if this option is not enabled.

Allow user to enter description for each upload lets users put a description on their attachments.

You may also choose which files types to accept as attachments, and customize the message for unsupported files.

Validation Attachment Type

Format

Some fields have Format properties. These set specific, fixed formatting for your fields, and are unique to the field type.

Form Editor Field Properties Format Text
Text field Format properties.

These properties only affect input data, not the Field Title or Help Text. In the example above, all user input in this text field will be forced Lower Case.

Form Editor Field Properties Format Number
Number field Format properties.

Advanced Tab

The Advanced tab has three main sections: Conditional Visibility, Concatenation, and Formula. The Attachment field also has a unique section called Upload to Drive.

Every field has Conditional Visibility. The other two, Concatenation and Formula, are specific to text and number type fields, respectively.

Conditional Visibility

This property lets you hide or show a field or section based on the value(s) of other fields.

Form Editor Field Properties Conditional Visibility
In this example, my text field will be hidden to the user if they haven’t selected an option in the Checkbox field.

Hide is currently the only available Action. It will hide the field if the conditions are met.

Action will trigger determines how to check the condition(s). There are two options:

  • If any of the following match means the action will be triggered if any of the conditions are met.
  • If all of the following match means the action will be triggered if all of the conditions are met at the same time.

Field is the field to check the condition against.

Operator is the condition that must be true for the Field. The Operators change depending on the type of field you choose. You can find a list of operators here.

Depending on the field and operator you choose, a Value section may appear where you can enter a value to compare the field contents against.

Form Editor Field Properties Conditional Visibility Options

When you click on Use Local Field the Value field is replaced by a drop-down menu of all fields on your form that can be used to check the Field against.

After selecting Use Local Field, a Use Value button will take its place which will return it to a Value.

https://vhu.937.myftpupload.com/wp-content/uploads/2018/04/ic_remove_circle_outline_black_36.pngSelect this icon to remove a condition.

Concatenation

As mentioned above, Concatenation properties are available for text type fields. This property lets you populate a field with the combined values of other fields. Users cannot edit a concatenated field directly, except by filling out the accompanying fields.

Form Editor Field Properties Concatenation

Field Name will have a list of fields currently on your form. Select a field from the drop-down to con, and there is also the option for Custom text.

Separator options include Space, Underscore _, Dash –, and Custom.

Form Editor Field Properties Concatenation Example
Concatenated text of the Name and Order Number fields, separated by a Dash.

You may keep adding fields with the ‘+ Add New Field‘ button. After adding a field, an ‘X’ will display to the right of it. Clicking the ‘X’ will remove the field.

Formula

Formula properties are available for number type fields, and it allows you to create a formula and populate the field with the results. Like the Concatenation section, users cannot directly edit a field that is using a formula, except by filling out the accompanying fields.

Form Editor Field Properties Formula
Formula multiplying a currency field by a number field. The result will populate this field.

Click a mathematical operator on the gray bar to add the operator to the formula.

Click ‘+ Field‘ to select an appropriate field from your form to add to the formula.

You may also type directly in the text area. Remember that a fields Short Code is used for formulas.

Form Editor Field Properties Formula Example
Using the formula in the first picture, Total Cost is Room Rate * Length of Stay.

Upload to Drive (Attachment field)

Turn this option on to automatically upload all newly attached files to a specific Drive folder.

Form Editor Field Properties Upload to Drive

A few things to note:

  • Whoever enables the feature will be the user used for uploading the files, so make sure that user has access to upload to that Drive.
  • There is a restriction when selecting a Team Drive (Shared Drive). If you want to use a Shared Drive, you can click on “Enter folder ID manually” and paste the Folder ID of the Shared Drive. The folder ID is found within the URL — don’t copy the full URL as it will not work.
  • You can either keep the file name as is, or you can rename the file using any field properties from the form. You can use the @ sign while typing and the select a field, or use the ${shortCode} of the fields you want to include.
  • Files will be uploaded to Drive only when the user saves or clicks on any workflow action on the record.
  • Files uploaded will not be deleted if the user deletes the file. 

Language Tab

The language tab gives you the option to translate your Field Title and Help Text to any language.

To do so, simply click the ‘+ Add Language‘ button and select the desired language from the drop-down list. Then, type in your translation in the Label and Tooltip text area.

Once you create a translation, the language will change according to the users browser language settings.

Form Editor Field Properties Language

For Radio, Checkbox, and List Selection fields, the Language Tab will have additional boxes to translate the options you created.

Form Editor Field Properties Language Options
https://vhu.937.myftpupload.com/wp-content/uploads/2018/04/ic_delete_black_36.pngClick on the trashcan icon to remove a language option.

Options Tab

The Options tab is unique to the field type. There are several fields with this tab: Rich Text, Radio Button, Checkbox, List Selection, Drive Picker, and Signature.

Rich Text

The Rich Text field options simply allow you to control which formatting options are available to users.

Form Editor Field Properties Rich Text Options

Radio Button & Checkbox

The Radio Button and Checkbox field options are identical.

Form Editor Field Properties Radio and Checkbox Options
Radio Button & Checkbox options.

The List Selection Values section is where edit the name, order, and appearance of your list options. You may also add options with the ‘+ Add Option‘ button.

https://vhu.937.myftpupload.com/wp-content/uploads/2018/04/ic_remove_circle_outline_black_36.pngSelect this icon to remove an option.

Sorting Direction will simply sort you options. If ‘None’ is selected, they will match the order in the List Selection Values section. To manually reorder, drag-and-drop the six dots on the right side of the option.

Show Icon displays individual icons to the left of the options. To change an icon, select it in the List Selection Values section (to the left of the list option) and select an icon from the pop-up.

Show Color will let you individually change the color of each list option. To change the color, select the down arrow to the right of the option in the List Selection Values section.

Format lets you choose how to display your options to users. The Preview on the right reflects how the user will see the options.

List Selection

The List Selection field options are also identical to the Radio Button & Checkbox options above. However, it also has two additional options.

Form Editor Field Properties List Selection Options

Allow Multiple Selections simply allows users to select more than one option.

Lookup from another form lets you search records from another form and use those records as options for the list selection. You cannot use this option with colors and icons, and turning it on will hide those options.

  • App is the app to lookup from.
  • Form is the associated form on the app.
  • Field to read from is the field on the form to lookup the value from.

Lookup Filters is where you set addition conditions to filter the records by. In the example above, my list selection will display names from ‘My Form’, but will only show records that have attachments. The Operator is context sensitive to the type of field. For more on filtering and operators, click here.

Driver Picker

The Drive Picker field options are divided into two sections: Features, and View Options.

Form Editor Field Properties Drive Picker Options

Features controls Google Drive permissions and visibility for the current user.

Form Editor Field Properties Drive Picker Options Views

Views Options lets you specify which file types will display to the user while using this field.

Signature

The Signature field options simply let you choose where in the available field space to display the signature box.

Form Editor Field Properties Signature Options
Updated on June 9, 2022

Was this article helpful?

Related Articles