Skip to main content

Set UI Element Data

Controlled node

Overview

The Set UI Element Data node programmatically updates the value of a form element in the user interface. Use this node to populate text fields, text areas, or other interactive elements with data generated during workflow execution. This is essential for creating dynamic forms that display computed values or data retrieved from external sources.

When the inList property is enabled, the node can target specific items within list elements (like repeating groups or tables), allowing you to update individual rows or nested elements.

Inputs

InputTypeDescriptionDefault
RunEventTriggers the node to write data to the specified form element.-
PageEnumThe display name of the page containing the target element.-
ElementEnumThe display name of the UI element to update.-
ValueDataThe value to set in the element. Can be text, numbers, or objects depending on the element type.-
List IndexData(Conditional) Required when inList is enabled. Specifies the index of the item in a list element. Accepts a number, comma-separated string for nested indices (e.g., "0,1,2"), or an array of numbers.-

Outputs

OutputTypeDescription
DoneEventFires when the value has been successfully written to the form element.

Runtime Behavior and Defaults

The node writes data to the runtime state at the path formData/{pageId}/{elementId}. When inList is enabled, the path includes the index suffix (e.g., formData/{pageId}/{elementId}_0).

Property Configuration

PropertyTypeDescriptionDefault
In ListBooleanEnable this if the target element exists inside a list (repeating group). When enabled, the List Index input appears, allowing you to specify which list item to update.false

Data Encoding

If the target element is configured with EditableData encoding (used for complex structured data), the node automatically converts the input value using mapObjectToWFData before writing. Otherwise, the value is written directly as-is.

Example Usage

Scenario: Update a text field with a calculated value after processing data.

  1. Add a Set UI Element Data node to your workflow.
  2. Connect the Done event from a processing node (like AI Write or Formula) to the Run input.
  3. Set the Page input to the name of your form page (e.g., "Main Form").
  4. Set the Element input to the display name of the text field (e.g., "Result Field").
  5. Connect the processed data output to the Value input.
  6. When the workflow runs, the text field will automatically populate with the computed value.

Working with Lists: To update the third item in a repeating group:

  1. Enable the In List property in the node's panel.
  2. Set List Index to 2 (zero-based index) or connect a number input.
  3. For nested lists (e.g., a list inside a list), use comma-separated indices like "0,2" to target the first parent's third child.