Support and Documentation

Types of form fields

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

Drop-down lists

In a drop-down field, a visitor selects one or more choices from a list of related items. The following table describes the fields in a Drop-down form.

Field

Description

Main widget

Label

Field's label.

Description

Field's description.

Type

Dropdown

Allow Multiple

Lets visitor select more than one option in the list.

Placeholder

Initial selection in the list, typically an informational message.

Required

Visitor must make at least one selection.

Choices

One or more choices available in the list. For details, see Choices.

Advanced widget

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 lists. Your version of Brightspot may render lists differently.

forms-dropdown-field.png
forms-dropdown-field-rendered.png
Checkboxes

In a checkboxes field, a visitor marks checkboxes from a list of related items. The following table describes the fields in a Checkboxes form. Your version of Brightspot may render drop-down lists differently.

Field

Description

Main widget

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 widget

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 example shows how Brightspot renders checkboxes. Your version of Brightspot may render checkboxes differently.

forms-checkboxes-field.png
forms-checkboxes-field-rendered.png
Radio buttons

In a radio buttons field, a visitor marks a single selection from a list of related items. The following table describes the fields in a Radio Buttons form. Your version of Brightspot may render drop-down lists differently.

Field

Description

Main widget

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 widget

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 example shows how Brightspot renders radio buttons. Your version of Brightspot may render radio buttons differently.

forms-radiobuttons-field.png
forms-radiobuttons-field-rendered.svg
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 widget

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 one line of text at most.

Placeholder

Field's initial value. Brightspot replaces the placeholder with the visitor's entry.

Required

Visitor must make an entry in the field.

Advanced widget

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 example shows how Brightspot renders a short text field. Your version of Brightspot may render text fields differently.

forms-text-field.png
forms-text-field-rendered.png
File uploads

In a file upload field, a visitor can upload a file from a laptop or mobile device. The following table describes the fields in a File Upload form.

Field

Description

Main widget

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 widget

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 example shows how Brightspot renders a file upload field. Your version of Brightspot, or your visitor's browser, may render file upload fields differently.

forms-file-upload-field.png
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 example shows how Brightspot renders a group of fields. Your version of Brightspot may render groups of fields differently.

forms-group-field.png
forms-group-field-rendered.png
Choices

Drop-down 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 widget

Label

Text appearing next to the checkbox, radio button, or in a drop-down list.

Advanced widget

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.