Form Fields

Last updated on August 01, 2024.

Use the 'Fields' tab to create and configure the fields for your form. Aside from adding fields, this document details other functionalities and features available in this tab. The list of topics covered by this document is as follows:

  • Adding a Virtual Field
  • Form Steps
  • Field Validation Rules

Adding a Virtual Field

To add a virtual field to the form:

  1. Navigate to Forms from the main menu.
  2. Select All Forms.
  3. Click CREATE FORM.
  4. Go to the 'Fields' tab.
  5. Select ADD FIELD.
  6. Fill out the form. Note that the form used to create a virtual field is divided into the following sections:

    • Field Details
    • Appearance
    • Advanced
    • Conditional Visibility
    • Validation Rules

    The details for each form section are discussed in its corresponding section in this article.

  7. Select ADD FIELD.
Important

The Form Builder only adds virtual fields to your form to ensure data integrity. Visit our documentation on Fields and Field Groups for reference on adding fields to a database.

Field Details

This form section provides basic details for a virtual field.

Input LabelTypeRequiredDescription
Enable Form FieldToggleNoThis toggle is used to indicate whether or not a field is enabled on the form. Disabling a field makes it unavailable for use on the front end.
Field TypeDropdown FieldYesThe type of field being added.
Input TypeDropdown FieldYesThe UI element used when a user edits database items. This element is the UI component used on your form when inserted via the Form Builder.
Field NameDisplay FieldYesThe name of the field used internally by Insites. The value displayed is based on the input in 'Field Label.'
Field LabelInput FieldNoThe label of the field provided by the user.
Display Field LabelToggleNoThis toggle is used to indicate whether or not the field label is displayed on the form.
Field Sub LabelCode EditorNoThe sub-label used to describe a field further.

Appearance

This form section determines the virtual field's appearance on the form.

Input LabelTypeRequiredDescription
PlaceholderInput FieldNoThe placeholder value displayed on a field to assist users with their inputs.
TooltipText AreaNoThe content of the tooltip displayed to provide users with more information about the field.
Hidden FieldToggleNoThis toggle is used to indicate whether or not the field is hidden on the form.
One Column FieldToggleNoThis toggle is used to indicate whether the field uses half the width of the form (Two Column Field) or the entire width of the form (One Column Field).

Advanced

This form section is used to configure advanced features for the virtual field you are creating.

Input LabelTypeRequiredDescription
Default ValueInput FieldNoThe default value used by the field should users leave the field unanswered.
Pre-fill KeyInput FieldNoA unique identifier used to populate fields with predefined or previously stored data automatically.
Enable CalculationToggleNoThis toggle is used to indicate whether or not calculations can be performed on the field.
FormulaCode EditorNoThe formula used to calculate an output based on the value provided for this field. This field can only be filled out if calculations are enabled.

Conditional Visibility

This form section is used to build conditional visibility rules for the virtual field you are creating.

Input LabelTypeRequiredDescription
Enable Conditional VisibilityToggleNoThis toggle is used to indicate whether or not the field uses conditional visibility. The feature hides or shows a field on the form based on user input on other fields.
Note

Please visit our documentation on Conditional Visibility for more details on using conditional visibility in your forms.

Validation Rules

This form section is used to create validation rules for your virtual field.

Input LabelTypeRequiredDescription
Validation Rule Dropdown Field Yes

The type of validation used by the field. Options include the following:

  • Required
  • Email
  • Format

Details regarding validation rules are discussed in a separate section in this document.

Form Steps

Insites allows you to build and use form steps, also known as multi-step or wizard-like forms. Form steps are a user interface design feature in which a longer or more complex form is divided into smaller, more manageable steps. Users typically navigate through these steps in a linear fashion, completing one form step at a time. Using form steps can improve the user experience by helping minimize errors and giving users an indication of their progress. They can be beneficial in mobile applications. To further enhance the user experience, you can also build conditional visibility in conjunction with form steps.

Some common examples where multi-step Forms can be beneficial include online registration forms, surveys, e-commerce checkout processes, and complex data entry forms.

Adding Form Steps

To add form steps to your form:

  1. Navigate to the 'Fields' tab on the form you are creating.
  2. Toggle Enable Form Steps to 'Enabled'
  3. Click ADD STEP.
  4. Fill out the form for creating a form step.
  5. Select ADD STEP.

Take note of the input needed for creating a form step:

Input LabelTypeRequiredDescription
Step Name Input Yes Name of the form step.

Sorting Form Steps

To sort your form steps:

  1. Click on the heading of the form step whose order you want to adjust.
  2. Drag and drop the form step to its preferred place in the form.
  3. Do the same to the other form steps until you achieve your desired sequence.

Sorting Fields in a Form

To sort fields in a form:

  1. Click on the field whose order you want to adjust.
  2. Drag and drop the field within the form or form step to its preferred place.
  3. Adjust the other fields until you achieve your desired sequence.
Important

If you have created form steps, you must assign all fields to a corresponding form step before attempting to generate the form code; otherwise, the system will not generate the form code.

Field Validation Rules

A field validation rule is a set of conditions applied to a field to ensure that data inputs meet certain predefined requirements or standards. These rules are established to validate data for accuracy, consistency, and compliance with specific business or data integrity rules.

To add a validation rule to the virtual field you are creating:

  1. Select a value on the 'Validation Rule' dropdown field. Options include the following:

    • Required
    • Email
    • Format

    The next couple of sections discuss the details of each option.

  2. Click ADD VALIDATION.

Required

This validation rule requires a user to provide an input.

Input LabelTypeRequiredDescription
Error MessageInput FieldNoError message displayed if a user leaves the field blank.

Email

This validation rule requires a user to provide a valid email address.

Input LabelTypeRequiredDescription
Error MessageInput FieldNoError message displayed if a user provides an invalid email address.

Format

This validation rule requires a user to provide an input that falls under the rules of their specified regular expression.

Input LabelTypeRequiredDescription
FormatInput FieldYesA regular expression that describes a custom format.
Error MessageInput FieldNoError message displayed if a user provides an input that falls outside the specified format.
Have a suggestion for this page?

Didn't quite find what you are looking for or have feedback on how we can make the content better then we would love to hear from you. Please provide us feedback and we will get back to you shortly.