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.
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.

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.

Field	Description
Main widget
Label	Field's label.
Description	Field's description.
Type	Checkboxes
Choices	One or more choices, each with its own checkbox.
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.

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.

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.
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.

Text

In a text field, a visitor enters text. 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. Most browsers validate the entry. Long Text—Visitor can enter almost unlimited text. Phone Number—Visitor enters text in the form of a phone number; Brightspotdoes not validate the entry. 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.

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.

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.

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.

Previous Topic

Creating a third-party form

Next Topic

Form submission actions