How do I display read-only data with a review table?

Last updated: June 18, 2026

A Review field shows data back to the employee as a read-only key/value table — facts you already have, or answers collected earlier in the form — without asking them to type anything and without risk of overwriting the underlying record.

Before you start

When to use a review table

Reach for a review table when the employee needs to see a value but shouldn't edit it — an employer's legal name, a set of agreed rates, or an address they confirmed on an earlier page. Because the field is display-only, it reads from a record without writing back to it, so it never overwrites the source the way an editable field bound to the same path would.

A review table is the right tool when you want several facts laid out as labeled rows. For a single value dropped into a sentence of body text, use a content block instead — see 📄 How do I add a content block with variables to a form?

Steps

Building a review table has three parts: add the field, add a row for each fact you want to show, then decide how each row is labeled and what happens when a value is empty.

Add the field

  1. Open the form in the Visual Builder and navigate to the page where the table belongs.

  2. Add a field and choose Review from the field type list. An empty review table appears in the field list.

Add a row for each fact

  1. Select the field and find the Table rows section in the field editor.

  2. Click Add row and set the row's path to the fact you want to show — an entity fact like employee.first_name or employer.name, or a field collected on an earlier page of this form.

    Repeat for every fact the table should display. Each row renders as one line: a label on the left, the resolved value on the right.

Set labels and empty handling

  1. Leave each row's label inherited by default — the row borrows the label of the field or fact it points at. Turn on the row's Use a custom label for this row toggle only when you want wording that differs from the source field.

  2. Decide what happens when a value is empty. By default a row with no value is hidden. Turn on Show when empty to keep the row visible even when the referenced value is blank.

  3. Save the field.

A row can only show a value that already exists when the page loads. Facts that exist before the form starts — employee.first_name, employer.name — are available from the first page. A value an employee types into the form isn't recorded until its page is submitted, so you can display a page-one answer on page two, but not a value being entered on the same page as the table. If a row stays blank, confirm the fact is collected earlier than the page the table sits on.

Verify

Click Preview in the form builder and confirm:

  • Each row shows the expected label and value, resolved from test data.

  • The values are read-only — there's no input to type into.

  • Rows you expected to see are present. If one is missing, open Facts next to Preview to confirm the path resolves, and check that the fact is collected before this page.

Related