Skip to main content

The List field

Offer a list of items to select from and configure its source, default value, display and export tag.

Overview of the List field

The List field offers the user a drop-down list of items to select from. The items can be entered directly in the field or come from an external list or an advanced list. It belongs to the Choices & lists category, along with Single choice, Multiple choice, Ranked choice and Reference.

Adding the field to a form

On the form creation screen, whether the form is new or existing, the field catalog on the left groups the fields into nine categories. Only one category is open at a time: click its name to open it. The List field is in the Choices & lists category, in first position. Hovering over the field displays a short description.

There are three ways to add the field:

  • Click List: the field is inserted just after the selected field. If no field is selected, it is added at the end of the form.

  • Drag and drop it from the catalog to the desired location. While you drag, the insertion areas are shown with a dotted outline.

  • The + button that appears below the hovered or selected field: it opens a menu with a search bar to insert a field at that exact spot.

As soon as the field is added, its title switches to edit mode: type its name and confirm with the Enter key. To rename it later, double-click its name. The mobile Preview updates with every change.

Accessing the field options

In the editing area, double-click the field or click the pencil icon (Edit). The options are displayed as cards.

They appear in this order: Essentials, List options, Visibility conditions, Display & layout and Advanced, followed by the Technical identifier.

There is no confirmation button: each setting is applied immediately, and ✓ Modified is displayed after each change. To move around the options:

  • Undo (the arrow at the top) or Ctrl+Z: goes back one step.

  • ↑ and ↓ in the header: move to the previous or next field without returning to the form.

  • Back (the arrow at the top left): closes the options and returns to the form.

â„č Good to know
Only the Save button saves the form permanently. Until you save, nothing is sent to mobile devices.

While the options are open, the catalog is greyed out. Close them to add a new field.

Essentials

This card contains the basic settings of the field.

  • Field title: by default, it is the name of the field type ("List"), but you can change it.

  • Choose an icon (the button to the left of the title): displays an icon in front of the field title, in the mobile app as well as in Web entry. Icons are grouped by theme (Statuses & alerts, Arrows & navigation, People & gender, etc.) and a search is available. No icon removes the icon.

  • Required entry: when this option is enabled, the user must fill in the field before submitting the form. The asterisk shown next to the field title, in the editing area, also lets you enable or disable it.

  • Multiple selection: allows the user to tick several values from the list. The Default value then accepts several items.

  • Help text shown on mobile: enter an instruction for your users. During data entry, they can view it by tapping the question mark shown to the right of the field title.

List options

This card defines where the items offered come from. Two modes are available:

  • Enter the items: you define the choices manually. The list can only be used in this form.

  • Link to a list: the items come from an external list or an advanced list, which can be reused in other forms.

Link to a list

In List link, select the external or advanced list whose items will populate the field. A search lets you find it quickly, and the type of each list (External list or Advanced list) is shown under its name.

  • Default value: search the list for the item displayed when the form opens. If Multiple selection is enabled, you can add several.

  • Filter the items: restricts the items offered based on the answers given in other fields. Once the option is enabled, build the rule in three parts: in IN THE LIST, choose the column of the list to compare; then choose the operator (is equal to, is different from, is less than, is less than or equal to, is greater than, is greater than or equal to, Contains, Does not include, is one of, is not one of); finally, in IN THE FORM, specify the comparison value: the value of the field, the fixed value or the custom user field.

To learn more about lists, see the How To Use The External List Page and Discovering Advanced Lists tutorials.

Enter the items

Click Add an item to create an item, then enter its label. The number of items is shown next to Items. On each row:

  • #: sets a code different from the label. The code is the stored value; it can stay empty. Clicking # again hides the code: it is then equal to the label.

  • The handle, on the left of the row, lets you reorder the items by drag and drop.

  • The bin, on the right, deletes the item.

Above the items, three buttons make them easier to manage:

  • Copy: copies the items with their codes.

  • Paste: replaces the list with the copied items.

  • Clear: deletes all the items in the list.

In Default value, choose the item displayed when the form opens. By default, no item is selected ("None").

⚠ Important
The field must be linked to an external or advanced list, or contain at least one entered item. Until it does, a warning message is displayed at the top of the options.

It is recommended to set short codes when the labels are long: they are easier to use in tags.

Visibility conditions

Three modes are available:

  • Always visible: the field always appears when entering data.

  • Visible if
: the field is displayed only when the conditions you define are met.

  • Always hidden: the field is never displayed during data entry, but remains usable in exports.

For details on setting up conditions, see the Visibility conditions tutorial.

Display & layout

This card customises how the field is displayed.

  • Title colour: choose from the colours offered. The first option, crossed out, means no colour. The colour applies in the mobile app as well as in Web entry.

  • Field title size: move the slider between Aa (smaller) and Aa (larger). The preview shows the resulting size in pixels (11 px by default). This size only applies in the mobile app.

  • On the same line as the previous field: this option places the field next to the previous one, in the mobile app only. It requires enabling the Allow multiple fields to be displayed on one line option in the mobile app settings.

Advanced

  • Keep the value from one row to the next: the value entered is automatically carried over to the next row of the table. This option only appears when the field is placed in a table.

  • No duplicates in the table: the user cannot enter the same value twice on different rows. This option only appears when the field is placed in a table.

  • Read-only when editing: the field stays visible, but can no longer be edited when the record is reopened for editing.

  • Personal data (GDPR): this option flags the field as personal data. In the data history, its content is then partially masked: only the last 3 characters remain visible, the others being replaced by asterisks. Clicking the eye icon shows the data in clear. This option does not make the data invisible: anyone with access to the data can view its full content.

  • Word: remove the line if empty: in a Word export, the paragraph containing the field's tag is removed if the field is empty.

    To learn more, see the Block tags and paragraph deletion tutorial.

Technical identifier and tag

Below the advanced options, the Technical identifier field shows the identifier of the field. It is used as-is in calculations and automations.

The tag to use in your custom exports is shown just below: ##list## for example. Clicking the tag copies it.

Tags are always enclosed in two hash signs (##). To customise them to your needs, see the Using tags to customize exports tutorial.

To show or hide content depending on the selected item, see the Block Tags and List/Choice tutorial.

💡 Tip

The technical identifier, and therefore the tag, can only be changed as long as the form has not been saved. It is recommended to customise it before the first save.

Did this answer your question?