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