List

Summary

The List field allows the end user to add/remove additional rows (up to a pre-set limit) of information per field. This allows for the capture of multiple field values, or a variable “list” of data as defined by the end user. This is a simple version of a repeater field. For more complex repeater functionality, check out this blog post about Collecting Repeatable Data in WordPress Forms. The List field is available under the Advanced Fields section within the form editor.

Common Settings

This field uses only common field settings for the Appearance settings. For a description of each of the common field settings, refer to this article. Below you will find description of specialty settings that are particular to this field.

General Settings

Setting	Description
Enable multiple columns	Checking this option enables the list field to have multiple fields per row. You may add as many columns as you need, each column with its own unique label.
Maximum Rows	Enter the maximum number of rows that users are allowed to add.

Advanced Settings

Setting	Description
Add Icon URL	Enter the URL of a custom image to replace the default ‘Add a new row’ icon +.
Delete Icon URL	Enter the URL of a custom image to replace the default ‘Remove this row’ icon -.

Merge Tags

For more information on the use of merge tags, refer to these articles.

Usage

{Field Name:2:modifier}

Modifiers

Modifier	Description
:text	To output the list items as text instead of HTML formatted.

Example

Below is an example showing a List field configured in the form editor.

And this short animation gives an example showing how it appears and behaves to a user filling out our form.

Related

Want to find out more about how the List field works? See our article about GF_Field_List.