List Selector


Select single or multiple pre-defined items. Also, support filtering base on existing field values.

(See this link for how to add values to your list: Adding Values.)




Admin Portal



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.

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

(Please 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"] }


Have more questions? Submit a request


  • Avatar
    Patrick H. Patin

    I was looking for an example of how the Field Filter Key can be used to limit the list of available options for a user based on the value of another field on the form.