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
| Input | Type | Description | Default |
|---|---|---|---|
| Run | Event | Triggers the node to write data to the specified form element. | - |
| Page | Enum | The display name of the page containing the target element. | - |
| Element | Enum | The display name of the UI element to update. | - |
| Value | Data | The value to set in the element. Can be text, numbers, or objects depending on the element type. | - |
| List Index | Data | (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
| Output | Type | Description |
|---|---|---|
| Done | Event | Fires 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
| Property | Type | Description | Default |
|---|---|---|---|
| In List | Boolean | Enable 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.
- Add a Set UI Element Data node to your workflow.
- Connect the Done event from a processing node (like AI Write or Formula) to the Run input.
- Set the Page input to the name of your form page (e.g., "Main Form").
- Set the Element input to the display name of the text field (e.g., "Result Field").
- Connect the processed data output to the Value input.
- 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:
- Enable the In List property in the node's panel.
- Set List Index to
2(zero-based index) or connect a number input. - 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.