Torq Interact supports two advanced table input elements, Row Selection and Editable Table, that let end users interact with table-type workspace variables directly within an Interaction. These elements extend the existing static Table capability by enabling controlled user input on structured data.

Overview

The Row Selection and Editable Table elements allow end users to either select specific rows from a table or edit table values inline as part of an Interaction Flow. This makes it possible to safely collect structured input, guide human decision-making, and update workspace variables, without granting users direct access to workspace variables or exposing them to the broader Torq environment.

Both elements are designed for controlled, auditable interaction with table data and apply changes only when the Interaction is submitted.

Row Selection element

The Row Selection element lets end users select one or more rows from a table-type workspace variable during an Interaction. The selected rows are returned as output and can be used by downstream workflow steps.

How it works

The table is presented to the user in a read-only format, with checkboxes that allow them to select one or more rows during the Interaction. When the Interaction is submitted, the full data for the selected rows is returned in the workflow context and can be used by downstream workflow steps.

Editable Table element

The Editable Table element lets end users edit table values inline during an Interaction. This enables controlled updates to table-type workspace variables using a structured UI.

How it works

The table is displayed with editable fields for permitted columns, while system-managed fields such as IDs and timestamps remain read-only. Users can make inline changes during the Interaction and, if needed, reset all edits to revert to the original table. Updates are applied to the table-type workspace variable only when the Interaction is submitted.

Prerequisites

Before using Row Selection or Editable Table in an Interaction:

A table-type workspace variable must already exist.
The table must be explicitly enabled for use in Torq Interact.
Editing must be explicitly allowed if you plan to use the Editable Table element.

How to use

Enable a table for use in Torq Interact

Configure table permissions: Open the table workspace variable settings.
Allow display and row selection: Enable the Available in Torq Interact option.
Allow editing: Enable the Editable in Torq Interact option if the table will be used with the Editable Table element.
Only tables with the appropriate permissions enabled will be available for selection in the Interaction Flow configuration.

Configure Row Selection or Editable Table in an Interaction

Add the table input element: In the Interaction configuration, add either Row Selection or Editable Table.
(Optional) Set the user-facing label: Adjust the Text shown to the end user.
(Optional) Set the context reference name: Specify the Context reference name used to reference the table output later in the workflow.
(Optional) Add helper text: Use Description to guide the user.
Select the table: Choose the enabled table workspace variable.
Configure table display:
- Choose which columns to show
- Set sorting and sort order
- Apply filters to control which rows are visible

Once configured, the table is rendered as an interactive input within the Interaction.

Expose a table via workflow

In addition to enabling a table from the workspace variables settings, you can expose (and optionally make editable) a table dynamically during workflow execution.

Use this method when table permissions should be controlled programmatically or changed as part of automation logic.

Add the step: In the Canvas, add the Expose a Table in Interact step (under Torq steps).
Configure the table name: Enter the relevant table name in the Table name parameter.
Enable display: Set the Exposed parameter to true to allow the table to be displayed in Torq Interact.
(Optional) Enable editing: Set the Editable parameter to true if the table will be used within the Editable Table element.

Resulting table experience for end users

When rendered inside an Interaction, Row Selection and Editable Table elements present structured, paginated tables with clear visual indicators and interaction controls.

Row Selection

When using Row Selection, end users will see:

A checkbox column on the left side of the table.
The ability to select one or multiple rows.
Standard table formatting including:
- Column headers
- Pagination controls
- Rows-per-page selector
Read-only data (users cannot modify values).

The selected rows are returned to the workflow context upon submission.

Editable Table

When using an Editable Table, end users will see:

A structured table with editable fields.
Metadata columns (such as id, created_at, created_by, updated_at, updated_by) displayed as read-only.
Editable cells rendered with appropriate input controls (for example, toggle buttons for boolean values).
A Reset changes button to revert all pending modifications before submission.
Pagination and rows-per-page controls similar to Row Selection.

Important behavior:

Edits are not applied immediately.
Changes only take effect after the Interaction is submitted.
If the user modifies values but does not submit the form, the table remains unchanged.
The submitted payload includes:
- The full updated table
- The number of rows modified