Types of Form Fields

The following sections describe the different types of fields available in forms.

Checkboxes

In a checkboxes field, a visitor marks checkboxes from a list of related items.

Field Description
Main tab
Label Field’s label.
Description Field’s description.
Type Checkboxes
Choices One or more choices, each with its own checkbox. For details, see Choices.
Advanced tab
Parameter Value for the parameter attribute of this field’s input tag. Your Brightspot developer uses this setting to ingest form data. You can also use this setting to populate emails with the information a visitor submitted. For details, see Email.

The following examples show how Brightspot renders checkboxes. Your version of Brightspot may render checkboxes differently.

../../../../_images/forms-checkboxes-field.png ../../../../_images/forms-checkboxes-field-rendered.png

Radio Buttons

In a radio buttons field, a visitor marks a single selection from a list of related items.

Field Description
Main tab
Label Field’s label.
Description Field’s description.
Type Radio Buttons
Choices One or more choices, each with its own radio button. For details, see Choices.
Advanced tab
Parameter Value for the parameter attribute of this field’s input tag. Your Brightspot developer uses this setting to ingest form data. You can also use this setting to populate emails with the information a visitor submitted. For details, see Email.

The following examples show how Brightspot renders radio buttons. Your version of Brightspot may render radio buttons differently.

../../../../_images/forms-radiobuttons-field.png ../../../../_images/forms-radiobuttons-field-rendered.png

Text

In a text field, a visitor enters text. You can perform data validation by selecting different types of text fields.

The following table describes the fields in a Text Field form.

Field Description
Main tab
Label Field’s label.
Description Field’s description.
Type

Type of text field.

  • Email—Visitor must enter text in the form of an email address.
  • Long Text—Visitor can enter almost unlimited text.
  • Phone Number—Visitor must enter text in the form of a phone number.
  • Short Text—Visitor can enter at most one line of text.
Placeholder Field’s initial value. Brightspot replaces the placeholder with the visitor’s entry.
Required Visitor must make an entry in the field.
Advanced tab
Parameter Value for the parameter attribute of this field’s input tag. Your Brightspot developer uses this setting to ingest form data. You can also use this setting to populate emails with the information a visitor submitted. For details, see Email.

The following examples show how Brightspot renders a short text field. Your version of Brightspot may render text fields differently.

../../../../_images/forms-text-field.png ../../../../_images/forms-text-field-rendered.png

File Uploads

In a file upload field, a visitor can upload a file from a laptop or mobile device.

Field Description
Main tab
Label Field’s label.
Description Field’s description.
Allowed File Types Types of files a visitor can upload with this field.
Allow Multiple Visitor can upload more than one file.
Required Visitor must upload at least one file.
Advanced tab
Parameter Value for the parameter attribute of this field’s input tag. Your Brightspot developer uses this setting to ingest form data. You can also use this setting to populate emails with the information a visitor submitted. For details, see Email.

The following examples show how Brightspot renders a file upload field. Your version of Brightspot, or your visitor’s browser, may render file upload fields differently.

../../../../_images/forms-file-upload-field.png ../../../../_images/forms-file-upload-field-rendered.png

Groups of Fields

You can group related fields under a heading, a technique that helps visitors better understand the form and what data is required in each field. The following examples show how Brightspot renders a group of fields. Your version of Brightspot may render groups of fields differently.

../../../../_images/forms-group-field.png ../../../../_images/forms-group-field-rendered.png

Choices

Dropdown lists, radio buttons, and checkboxes have one or more choices from which a visitor makes selections. You create a field’s choices using the Choice form. The following table describes the fields in a Choice form.

Field Description
Main tab
Label Text appearing next to the checkbox, radio button, or in a dropdown list.
Advanced tab
Parameter Value for the parameter attribute of this field’s input tag. Your Brightspot developer uses this setting to ingest form data. You can also use this setting to populate emails with the information a visitor submitted. For details, see Email.