The list field lets your end client enter multiple rows of information in response to a single question, and can be switched to a table format using the List with Columns option.
What is the List Field?
The list field in Gatheroo gives clients an input that allows them to add multiple line items in response to one question.
Each time they complete a row, they can add another, making it ideal for collecting variable-length lists of information.
The list field also has a unique built-in option: List with Columns. Selecting this transforms the list into a table, where you define the column headers and clients fill in a row for each item.
List Field, with or without columns, are exported as CSV files, allowing you to use the information in your favourite spreadsheet tool.
When to Use a List Field
Use the list field when a client may need to provide multiple entries of the same type.
Common examples include:
- Business Goals
- Staff Names
- List of directors or shareholders
- List of properties owned
- Itemised expenses or income sources
- Previous employment history
- Beneficiaries of a trust
List with Columns: Table Format
When you select List with Columns on a list field, the input becomes a structured table.
You define the column headers (such as “Name”, “Date of Birth”, “Ownership %”) and the client fills in each row.
They can add as many rows as they need.
This is different from the standard list field, which is a simple multi-row text input without column structure.
Use List with Columns when the data you’re collecting has consistent attributes that belong in a table.
Note: The List with Columns option is set directly on the field itself in the Request Builder, not in the field settings popup.
How to Add a List Field to Your Request
- In the Request Builder (Step 2), navigate to the section where you want the field
- Click the + (Add Field) button
- In the field type dropdown, select List
- Enter your question in the Field Name box
- To enable the table format, select List with Columns on the field and define your column headers
- Click Save
List Field Settings
- Mandatory: require the client to add at least one entry before submitting
- Conditional Logic: show this field only when a specific Single Select answer has been given
Frequently Asked Questions
What is the list field in Gatheroo?
The list field in Gatheroo allows end clients to enter multiple rows of information in response to a single question.
It can also be set to List with Columns to become a structured table with custom column headers.
What is the difference between a list field and a repeatable field in Gatheroo?
A list field is a single field that accepts multiple line items or table rows within itself.
A repeatable field setting can be applied to other field types (like Single Text Line or Address) to allow clients to add multiple instances of that entire field.
How do I create a table in a Gatheroo request?
Use the list field and enable the List with Columns option. Define your column headers and clients will be able to fill in as many rows as they need in a structured table format.
Can I make a list field mandatory?
Yes. Open the field settings using the gear icon and toggle on Make this field mandatory to complete .
How do I collect a list of items from a client in a form?
Use a repeatable list or list field that lets clients add multiple items one by one.
This is ideal when you need clients to enumerate things like directors, shareholders, properties, or services, where the number of entries varies per client.
In Gatheroo, the List field allows clients to add as many rows as needed.
What is a repeatable field in a client intake form?
A repeatable field is one where clients can add multiple instances of the same type of information, for example, listing several company directors, multiple addresses, or a series of transactions.
It avoids the problem of having a fixed number of fields that may not match every client’s situation. Gatheroo’s List field works this way.