Choice fields allow visitors to select from choices that you configure. To add a choice field: Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one. Under Items , click add_circle_outline and select Choice Field . Under Label , give the choice field a label. Under Description , give the choice field a description. Under Type , select how the choice will be displayed to the user. The following options are: Dropdown —The user selects choices from a dropdown. Allow Multiple —Toggle on to allow multiple selections from the dropdown. Placeholder —Enter text that will appear inside the dropdown before being clicked. Required —Toggle on if the selection(s) made in this dropdown are required. Checkboxes —The user selects choices by clicking checkboxes. Preset —Select a preset style for the checkboxes if any exist. Number of Columns for This Field Set —Select one of the options to determine which percentages of the page the checkboxes columns occupy. Radio Buttons —The user selects choices by clicking radio buttons. Preset —Select a preset style for the checkboxes if any exist. Number of Columns for This Field Set —Select one of the options to determine which percentages of the page the radio buttons columns occupy. Under Choices , click add_circle_outline , and then give the choice a name by entering a value in the Label field. (Optional) Under the Advanced tab, in the Parameter field, enter a value for the input parameter attribute of this field's input tag (for example, <input type="text" paramater="my-input-name" /> ). A developer can use this setting to ingest form data, or it can be used to populate emails with the information a visitor submitted.

Dynamic Hidden fields allow you to use web properties to discover additional insights about the users who fill out the form. To add a Dynamic Hidden field: Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one. Under Items , click add_circle_outline and select Dynamic Hidden Field . Under Name , enter a name for the dynamic hidden field. This name is not displayed to the user who fills out the form. Under Dynamic Source , select the desired web property that you want to track: Document.Referrer —Captures the page from which a visitor came before landing on your form page. For details, refer to web property documentation . HTTP Cookie —Captures data stored in the visitor's browser cookie. Under Cookie Name , specify the cookie. Query Parameter —Captures information that is passed into the page via the URL. Under Parameter Name , specify the parameter.

File Upload fields allow the visitor to upload files as part of their form submission. To add a File Upload field: Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one. Under Items , click add_circle_outline and select Dynamic Hidden Field . Under Label , give the file upload field a label. Under Description , give the file upload field a description. Under Allowed File Types , click add_circle_outline , and then select the file types the visitor should be allowed to upload ( Image , Video , Audio ). Toggle on Allow Multiple to allow multiple file uploads. Toggle on Required to make this field required. (Optional) Under the Advanced tab, in the Parameter field, enter a value for the input parameter attribute of this field's input tag (for example, <input type="text" paramater="my-input-name" /> ). A developer can use this setting to ingest form data, or it can be used to populate emails with the information a visitor submitted.

Group fields allow you to group together other form fields. To add a Group field: Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one. Under Items , click add_circle_outline and select Group . Under Title , give the group a label. Under Description , give the group a description. Under Items , add a form field. Refer to the documentation on this page for additional details about form field types.

Hidden fields allow you to capture additional data points when the visitor submits the form. To add a Hidden field: Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one. Under Items , click add_circle_outline and select Hidden Field . Under Name , enter the name of the value that you want to be submitted when the form is submitted. Under Value , enter the value that you want to be submitted when the form is submitted. (Optional) Under the Advanced tab, in the Parameter field, enter a value for the input parameter attribute of this field's input tag (for example, <input type="text" paramater="my-input-name" /> ). A developer can use this setting to ingest form data, or it can be used to populate emails with the information a visitor submitted.

Text fields are standard fields where a visitor enters data to submit as part of the form. To add a Text field: Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one. Under Items , click add_circle_outline and select Text Field . Under Label , give the text field a label. Under Type , select one of the following: Short Text —Adds a simple text field to the form into which a visitor may type. Email —Adds a text field to the form into which a visitor may type an email address. Long Text —Adds a large text field into the form into which a visitor may type. Phone Number —Adds a text field to the form into which a visitor may type a phone number. Under Placeholder , enter text that will appear inside the text field before being selected. Toggle on Required to make this a required field. (Optional) Under the Advanced tab, in the Parameter field, enter a value for the input parameter attribute of this field's input tag (for example, <input type="text" paramater="my-input-name" /> ). A developer can use this setting to ingest form data, or it can be used to populate emails with the information a visitor submitted.

Brightspot Content Types Guide

Modules

Form module

Back to Form module

Types of form fields

The following sections describe the different types of fields available in forms. You select and fill out these fields from the Items field when creating or updating a contact form, custom form, or third-party form.

Captcha field

Captcha fields validate whether the visitor filling out the form is human. Brightspot only displays captcha fields if you have configured captcha in Sites & Settings. For details, see Configuring Google ReCAPTCHA. For additional details on adding captcha to forms, including Invisible Captcha, see Adding Google reCAPTCHA to forms.

Choice field

Choice fields allow visitors to select from choices that you configure.

To add a choice field:

Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one.
Under Items, click add_circle_outline and select Choice Field.
Under Label, give the choice field a label.
Under Description, give the choice field a description.
Under Type, select how the choice will be displayed to the user. The following options are:
- Dropdown—The user selects choices from a dropdown.
  - Allow Multiple—Toggle on to allow multiple selections from the dropdown.
  - Placeholder—Enter text that will appear inside the dropdown before being clicked.
  - Required—Toggle on if the selection(s) made in this dropdown are required.
- Checkboxes—The user selects choices by clicking checkboxes.
  - Preset—Select a preset style for the checkboxes if any exist.
  - Number of Columns for This Field Set—Select one of the options to determine which percentages of the page the checkboxes columns occupy.
- Radio Buttons—The user selects choices by clicking radio buttons.
  - Preset—Select a preset style for the checkboxes if any exist.
  - Number of Columns for This Field Set—Select one of the options to determine which percentages of the page the radio buttons columns occupy.
Under Choices, click add_circle_outline, and then give the choice a name by entering a value in the Label field.
(Optional) Under the Advanced tab, in the Parameter field, enter a value for the input parameter attribute of this field's input tag (for example, <input type="text" paramater="my-input-name" />). A developer can use this setting to ingest form data, or it can be used to populate emails with the information a visitor submitted.

Dynamic Hidden field

Dynamic Hidden fields allow you to use web properties to discover additional insights about the users who fill out the form.

To add a Dynamic Hidden field:

Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one.
Under Items, click add_circle_outline and select Dynamic Hidden Field.
Under Name, enter a name for the dynamic hidden field. This name is not displayed to the user who fills out the form.
Under Dynamic Source, select the desired web property that you want to track:
- Document.Referrer—Captures the page from which a visitor came before landing on your form page. For details, refer to web property documentation.
- HTTP Cookie—Captures data stored in the visitor's browser cookie. Under Cookie Name, specify the cookie.
- Query Parameter—Captures information that is passed into the page via the URL. Under Parameter Name, specify the parameter.

File Upload field

File Upload fields allow the visitor to upload files as part of their form submission.

To add a File Upload field:

Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one.
Under Items, click add_circle_outline and select Dynamic Hidden Field.
Under Label, give the file upload field a label.
Under Description, give the file upload field a description.
Under Allowed File Types, click add_circle_outline, and then select the file types the visitor should be allowed to upload (Image, Video, Audio).
Toggle on Allow Multiple to allow multiple file uploads.
Toggle on Required to make this field required.
(Optional) Under the Advanced tab, in the Parameter field, enter a value for the input parameter attribute of this field's input tag (for example, <input type="text" paramater="my-input-name" />). A developer can use this setting to ingest form data, or it can be used to populate emails with the information a visitor submitted.

Group field

Group fields allow you to group together other form fields.

To add a Group field:

Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one.
Under Items, click add_circle_outline and select Group.
Under Title, give the group a label.
Under Description, give the group a description.
Under Items, add a form field. Refer to the documentation on this page for additional details about form field types.

Hidden field

Hidden fields allow you to capture additional data points when the visitor submits the form.

To add a Hidden field:

Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one.
Under Items, click add_circle_outline and select Hidden Field.
Under Name, enter the name of the value that you want to be submitted when the form is submitted.
Under Value, enter the value that you want to be submitted when the form is submitted.
(Optional) Under the Advanced tab, in the Parameter field, enter a value for the input parameter attribute of this field's input tag (for example, <input type="text" paramater="my-input-name" />). A developer can use this setting to ingest form data, or it can be used to populate emails with the information a visitor submitted.

Text field

Text fields are standard fields where a visitor enters data to submit as part of the form.

To add a Text field:

Search for and open an existing form asset (contact form, custom form, or third-party form), or create a new one.
Under Items, click add_circle_outline and select Text Field.
Under Label, give the text field a label.
Under Type, select one of the following:
- Short Text—Adds a simple text field to the form into which a visitor may type.
- Email—Adds a text field to the form into which a visitor may type an email address.
- Long Text—Adds a large text field into the form into which a visitor may type.
- Phone Number—Adds a text field to the form into which a visitor may type a phone number.
Under Placeholder, enter text that will appear inside the text field before being selected.
Toggle on Required to make this a required field.
(Optional) Under the Advanced tab, in the Parameter field, enter a value for the input parameter attribute of this field's input tag (for example, <input type="text" paramater="my-input-name" />). A developer can use this setting to ingest form data, or it can be used to populate emails with the information a visitor submitted.