List Field

Getting there

1. In the Campaign Builder, drag and drop the Field Widget into a Form Container.

2. In the pop-up, select List from the Custom Field list.

3. Click Next to proceed.

Field settings

Layout

Allow multiple selections

If entrants can select more than one list option, check the Allow Multiple Selections box. Layout options include:

• List: Displays all choices at once; entrants click to select their choices.

• Checkboxes: Choices appear with checkboxes for selection.

• Tiles: Choices appear as tiles, suitable for adding images.

Single-selection layout options

If multiple selections are not allowed, layout options include:

• Dropdown: A classic dropdown menu for single selection.

• Radio Buttons: Choices are displayed with radio buttons for selection.

• Tiles: Displays choices as tiles with image support.

• Text: A blank text field where entrants manually enter a list item. (Case-sensitive when using Text Layout)

Note: The Text layout can also be used as a code redemption feature.

Text

Assign Labels or Prompts (for dropdown layouts only) in this section to guide entrants.

Validation

Select one of the following options:

• Always: Field is always mandatory.

• When Visible: Field is mandatory only when visible.

• Never: Field is not required.

Error messages

Customize error messages by entering your desired text in the appropriate fields.

Content

Define your list choices in this section.

Input modes

Text Input Mode:

• Type each choice on a separate line.

• Capitalization matters when using the Text Layout.

Prompted Input Mode:

• Enter choice text, add a value (e.g., monetary value for certain templates), and optionally add an image.

• Use the + icon to upload an image via the Media Library.

• Add a new choice with the Add Choice button.

• Delete choices with the trash can icon.

Default value

Select a default choice or leave it blank to keep the field unselected initially.

Field points

Assign a point value to the field to award entrants additional points for completing this field.

Other

Instructions field

Add text to the Instructions field to display below the field when it is focused (selected).

CSS classes

Add custom CSS classes to the Extra CSS classes field for styling via the CSS Editor.

Visibility

Control field visibility by:

• Date and Time: Limit field visibility to a specific period.

• Pop-Up Display: Show the field as a pop-up.

• Builder Only: Limit field visibility to the Campaign Builder.

• Country Restrictions: Show the field only in specific countries.

Learn more about Widget Visibility.

Extras

Learn more about the Main Tag, CSS Classes, and Smart Labels settings in Widget Extras.

List field styling options

When the Widget is selected, you can customize the styling of the specific widget. Some of the options include changing the list item font type, the maximum width of the widget, and widget alignment. You will see the following areas of styling available in the Style Panel:

• Labels

• List Box

• List Items

• Help Text

• Widget

Related resources

How to Build a Form (Video)

How to Configure the List Field