Skip to main content

Read-only Grid

Overview

Read-Only Grid displays a list in table or dropdown format. Unlike Grid and Table, it does not bind to the form’s own array field. It is built to show rows from a Data Table, a dataset that an organization manages centrally rather than on any one form.

Add a Read-Only Grid to a form

Open the Component Selector and expand the Data Groupings category. Drag Read-Only Grid onto the form.

Read-Only Grid does not prompt for a field to bind, the way Grid and Table do. It drops onto the form with a hidden field of its own, and it renders with no rows until it has data to show.

Read-Only Grid’s key settings

Select Read-Only Grid on the canvas and open its Control Properties (the wrench icon) to reach these settings.

Type switches the control between a table layout and a dropdown layout. Height sets the control’s pixel height, 200 by default. Label Field points at a field whose value should label each row.

Enable Refresh, Enable Search, and Enable Selections turn a refresh control, a search box, and row selection on or off. Enable Selections is on by default; the other two are off by default.

Grid, Table, and Read-Only Grid are not the same mechanism

Grid and Table both bind to an array field already on the form. Adding a row there adds a row to that field, and removing a row removes it from the field. Read-Only Grid works differently: it does not read or write any array field on the form. It is a viewer built to show rows from a Data Table, an organization-managed dataset kept separate from any single form.