Table Control

The Table control allows you to create a structured grid of rows and columns within a task. Each cell can be configured as editable or read-only, and individual cells can be marked as required. Users fill in the editable cells when working through the checklist.

This is useful for capturing structured data such as inspection scores, inventory counts, measurements, or any information that fits naturally into a tabular format.

Add to the Template

The Table control can be added from the controls toolbar in the Template.

Once added, you will see a default grid. You can configure the table as follows:

Label

You can set an optional label that is displayed above the table to give it a heading or describe its purpose.

Adding and Removing Columns

Use the column controls to adjust the number of columns:

  • Add Column Left — Inserts a new column to the left of the selected column.
  • Add Column Right — Inserts a new column to the right of the selected column.
  • Delete Column — Removes the selected column.

Adding and Removing Rows

Use the row controls to adjust the number of rows:

  • Add Row Above — Inserts a new row above the selected row.
  • Add Row Below — Inserts a new row below the selected row.
  • Delete Row — Removes the selected row.

Cell Settings

Click on any cell to access its settings menu. Each cell can be configured with the following options:

  • Value — The text to display in the cell. Cells with a pre-filled value are typically used as column headers or row labels.
  • Read-Only — When enabled, the cell cannot be edited in the checklist. Use this for headers and labels.
  • Required — When enabled, the cell must have a value entered before the parent task can be completed.
  • Background Color — Apply a background color to the cell to aid visual categorisation. The available colors are: Red, Orange, Yellow, Green, Blue, Grey, and White (default).

Allow Add/Remove Rows in Checklist

Check the Allow Add/Remove Rows in Checklist option to allow users to dynamically add or remove rows when working through the checklist. This is useful when the number of data rows is not known in advance.

Use in the Checklist

The Table control displays as a grid in the Checklist. Editable cells can be clicked and typed into. Read-only cells display their pre-configured values and cannot be modified.

If Allow Add/Remove Rows was enabled in the template, users will see buttons to add a new row at the bottom of the table or delete an existing row.

Validation

If any cells are marked as Required, validation is performed when the user completes the task. The task cannot be completed until all required cells have a value entered.

Validation error messages are shown below the table.

If you try to complete a task outside of the checklist (e.g. from the Dashboard) and it fails validation we will notify you of the validation failure via a pop-up message.