List selector

  • 2 minute(s) read
Prev Next

Overview

The List field allows you to create a dropdown list by entering single or multiple pre-defined items. This helps streamline data entry for your users in the field, who can simply select an item from a list, instead of having to type it manually.

How to create a list selector

  1. In the Legacy Form Builder, add a List field to your form.

  2. Select Add List Items.

  3. Enter an item under the Name column and select Add. Repeat to complete your list.

  4. Select OK when finished.

The List field also supports list filtering, as well, if you are looking to filter a list made by another list selection.

List anatomy

List anatomy diagram showing Name, Value, Filter Key, and Score columns

  1. What is the Name in a list?

    The Name is what is shown/displayed in the apps. This does not have to be the same as the value, although it is set this way by default.

  2. What is the Value?

    The Value is what is shown on the reports. They would not be the same in many instances, most often used with calculations to automatically calculate different fields in your form.

  3. What is the Filter Key?

    The Filter Key is used to filter your list based on another list 

  4. What is the Score?

    This is also used in calculations. You can assign a numerical score to a list selection. For example, if you have a product price list, you can assign numeric values to your products, pull those into a calculation field to use for calculations, etc.

    List selector field on mobile showing a dropdown with items

Configuration

Setting

Description

Field Label

The label displayed for the field. This is usually displayed at the top left corner above the field.

Field Key

A Key used to reference the field in submission data. The key is also used to reference the field in rules and calculations.

Placeholder Text

The text that is displayed if the field has no value set, e.g. "Please enter a value"

Field Filter Key

A referenced Field Key of another field that will filter the Values based on the Values - Filter Key.

Allow Multi-Selection

 If checked allows more that one option to be chosen.

Memory Field

If a previous form containing the same Field Key has a value set, it's value will be pre-populated for this field when the form is first opened.

Rule

A JavaScript rule snippet that allows you to perform actions on fields or sections within the form. The actions can include hide, show, enable, disable, showSection and hideSection. Rules are executed on field value changes and when the form is opened.


ex.
if ($field1$ > 23) { hide(); } else { show(); }

(See the Introduction to Rules document for more information)

Required

Sets the field to have required input. You will not be able to submit the form until this field has valid input.

Enabled

If not set the field will be visible but cannot be edited or set to accept new input.

Hide Field Label

Hides the Field Label.

Hidden

If enabled the field and all labels are not visible.

Exclude From Reports

If checked, the field will be excluded from HTML and PDF reports and will also be excluded from Excel and CSV exports.

Capture Geo Location

Capture the current latitude and longitude when the acknowledgment button is clicked.

Capture Time Stamp

Capture the current date and time when the acknowledgment button is clicked.

Alert Type

Choose a theme to change the background and font colors of the field cell as displayed in the apps.

Values

A list of values that will be populated in the list.

Value - Name

The displayed value shown in the List.

Value - Value

The value that is sent when the form is submitted.

Value - Filter Key

A key used to filter the available Values if a Field Filter Key is specified.

Result Data

Data Type

Domain of Values

Example JSON

String Array

N/A

{ "list_1": ["abc", "123", "hello"] }