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.
- Field Label
Enter the label of the form field. This is the field title the user will see when filling out the form.
Enter the description for the form field. This will be displayed to the user and provide some direction on how the field should be filled out or selected.
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 it’s own label.
Enter the maximum number of rows that users are allowed to add.
These properties set rules for how the data should be handled.
A required field will prevent the form from being submitted if it is not filled out or selected.
- Description Placement
Use this dropdown to determine whether the description will be displayed above or below the inputs.
Custom Validation Message
If you would like to override the default error validation for a field, enter it here. This message will be displayed if there is an error with this field when the user submits the form.
Custom CSS Class
Enter the CSS class name you would like to use in order to override the default styles for this field.
- Admin Field Label
Enter the admin label of the form field. Entering a value in this field will override the Field Label when displayed in the Gravity Forms administration tool.
Add Icon URL
Enter the URL of a custom image to replace the default ‘add item’ icon.
Delete Icon URL
Enter the URL of a custom image to replace the default ‘delete item’ icon.
Select the visibility for this field. Field visibility set to Everyone will be visible by the user submitting the form. Form field visibility set to Admin Only will only be visible within the Gravity Forms administration tool. Setting a field to Admin Only is useful for creating fields that can be used to set a status or priority level on submitted entries.
Allow field to be populated dynamically
Check this option to enable data to be passed to the form and pre-populate this field dynamically. Data can be passed via Query Strings, Shortcode and/or Hooks.
Enable Conditional Logic
Create rules to dynamically display or hide this field based on values from another field. Remember, to use conditional logic, you will need to create a drop down, checkbox or multiple choice field.
To output the list items as text instead of HTML formatted.