A Table field lets you build a structured grid of columns for form data entry. Unlike a List field, which repeats a single field, a Table supports multiple related fields per row. Rows can be pre-populated when you build the template, added by users filling out the form, or both.
Note: Selecting Table adds it to your form immediately. A Field Name is required before the field is complete, so name it right away.
Build the Table
- Click New Group. A field must belong to a group, so this comes first.
- Click New Field +.
- Select the Specialty tab.
- Click Table. The field is added to your form right away.
- Enter a Field Name for the table.
- Select the Table tab.
- Add your column types, clicking + Add Column for each one you need. At this stage you're only choosing the type for each column, not naming it, naming happens afterward.
- You can drag and re-order the columns listed
- Select your Display Column, then reorder or remove columns as needed.
- Click Done.
Display Column
Controls which column's entered value is shown as each row's label, instead of a generic label like Row 1 or Row 2.
Use it when: you want rows to be identifiable by a meaningful value, like a worker's name or an asset ID, rather than a row number.
Name Your Columns
Once you're back on the main template screen, your table appears with its columns. Click the pencil icon next to any column to rename or edit it, the same way you'd edit any other field.
Pre-Populate Rows (Optional)
You can preset specific rows with data while building the template, using the same + Add Row control that end users see when filling out the form.
Note: Pre-added rows aren't locked. Users can remove them the same way they remove any row they add themselves, and they can also add more rows beyond the ones you've predefined.
What Happens Next
Once published, users see the table with any rows you pre-populated already in place, each labeled using the value in your Display Column. Users can add more rows with + Add Row, or remove any row, including the ones you pre-added, the same way.
Frequently Asked Questions
Can I lock a pre-added row so end users can't remove it?
No. Any row, including ones you add while building the template, can be removed by the person filling out the form.
What does the Display Column actually control?
It determines which column's value is used to label each row, instead of a generic label like Row 1 or Row 2.
Should I use a Table or a List field?
Use List when you only need to repeat one field per entry. Use Table when you need multiple related fields per row, like paired measurements or readings.
Can I rename a column after the table is created?
Yes. Click the pencil icon next to any column from the main template screen to rename or edit it.
Can I total a column of numbers in my table?
Yes. Add a Calculation (Table) field pointed at a Number column. See our Form Builder: Calculations article for setup steps.
Do I have to define columns before naming them?
Yes. Column types are chosen first, and naming each one happens afterward from the main template screen.