Skip to content

Grid#

The Grid element captures structured tabular input. You lay out the columns and rows up front, and each column decides what kind of value its cells accept — text, a number, a date or time, or a checkbox. At runtime the user fills in the cells of the resulting table.

It is a good fit for matrix-style data such as measurement tables, checklists with several attributes per item, or any input that is naturally organized into rows and columns.

Introduced in release 2026.11.

Example#

Grid element with two columns and two rows next to its settings panel

The grid above has two text columns (Column 1, Column 2) and two fixed rows (Row 1, Row 2). Both the header row and the header column are enabled, so the column titles run across the top and the row titles down the left, while every body cell shows a Value input.

The design-time preview renders each column with its actual input control — a text field, number field, date/time picker, or checkbox, matching what the user will see at runtime — instead of static sample values. For Dynamic rows, the preview also shows the add / remove row buttons.

Columns#

Each column defines:

  • Type — the input type used for every cell in that column: Text, Number, Date, Time, Date-Time, Checkbox, or Static Text.
  • Label — the column title shown in the header row (when Show header row is enabled).
  • Help — optional help text for the column. When set, a tooltip icon (?) appears next to the column label; hovering or tapping it shows the text. See Help texts.
  • Static text value — visible only when the column type is Static Text. The text you enter here is displayed in every cell of that column at runtime — the user cannot edit it.

Add a column with the green + button and remove one with the red – button beside it.

Column types#

Type Description
Text Free-text input.
Number Numeric input.
Date Date picker.
Time Time picker.
Date-Time Combined date and time picker.
Checkbox Single checkbox (boolean).
Static Text Fixed label typed by the designer — not editable by the user at runtime. Useful for displaying a tolerance, a unit, or any other constant value next to a user-input column.

Tip: Use Static Text alongside a Number column to show a fixed tolerance value in the adjacent cell — for example a Number column for the measured value and a Static Text column showing 35.02 / 35.12.

Example — Cleaning Log: A grid with a Text column (Area), a Static Text column (Cleaning Agent) with value IPA 70%, and a Checkbox column (Done). The cleaning agent is fixed for every row — the user only fills in the area and checks the box.

Static Text column example

Rows#

How rows behave depends on the row mode:

  • Fixed rows — you predefine the rows in the element settings. Each row has a label shown in the header column, and the same set of rows appears every time the UI runs. Add or remove rows with the + / – buttons. Each row also has an optional Help text, shown the same way as a column's — see Help texts.
  • Dynamic rows — rows are not predefined. The user adds (and removes) rows themselves while filling in the form, which is useful when the number of entries is not known in advance.

Help texts#

Both columns and (fixed) rows can carry their own optional Help text, independent of the element-level Help setting. When a column or row has a help text set, a small tooltip icon (?) is shown next to its label — in the header row for columns, and in the header column for rows. Hovering (or tapping, on touch devices) the icon reveals the text.

This is useful for clarifying what a specific column or row expects — for example, the tolerance range for a measurement column, or extra instructions for one particular checklist row — without cluttering every cell with instructions.

Header row and header column#

  • Show header row — displays the top row carrying the column labels.
  • Show header column — displays the left column carrying the row labels.

Each header has its own alignment (for example Center) and text-styling controls, so the headers can be visually distinguished from the body cells.

Settings#

Setting Description
Label The element label shown above the grid.
Help Optional helper text describing the element.
Required If checked, the element must be filled in before the form can be submitted.
Disabled If checked, the grid is read-only and cannot be edited at runtime.
Show label If checked, the element label is displayed.
Fixed rows / Dynamic rows Chooses whether rows are predefined or added by the user at runtime.
Show header row Shows the top header row with the column labels.
Show header column Shows the left header column with the row labels.
Columns The list of columns, each with a cell Type, a label, and an optional Help text.
Rows The list of (fixed) row labels, each with an optional Help text.
Header row / Header column Alignment and text styling for each header.
Margins Spacing around the element. See Margins.
Reference A unique reference for addressing the element from the Flow Designer. See Reference.

Notes#

  • Cell input types are set per column, so an entire column collects the same kind of value.
  • Use Fixed rows for known, labelled rows (for example a measurement matrix or a fixed checklist) and Dynamic rows when the user decides how many entries to add.

See also UI Designer