Skip to content

Use the Workflow Editor

The workflow editor organizes nodes into an executable workflow. Nodes perform operations, connections determine execution order, and Workflow Settings control shared canvas and runtime behavior.

Editor Areas

AreaPurpose
Node libraryFind nodes by category or search by name
CanvasPlace nodes, connect them, and adjust workflow structure
Node configurationEdit parameters, variables, notes, and outputs for the active node
ToolbarSearch canvas nodes, undo, arrange, import, debug, and save
MinimapView the complete workflow and move quickly to another canvas area
Workflow editor areas
Workflow editor areas

Add Nodes

Every workflow contains a Start node for global variables. It cannot be deleted.

Add other nodes in either way:

  • Drag: Drag a node from the library to a specific canvas position.
  • Append: Click the plus icon beside a node to append it to the current main flow.

Search the node library by name. Try terms such as "click," "Excel," or "loop" to narrow the list.

Two ways to add a node
Two ways to add a node

Configure a Node

Select a node and enter its parameters in the configuration panel. Fields depend on the node type and commonly include:

  • Input values or variable-enabled text.
  • Element selectors or saved element objects.
  • Timeout and wait behavior.
  • Output variable name.
  • Notes or description.

Complete every required field. An output variable must be a valid JavaScript identifier and is available only to downstream nodes from its source node onward.

For node fields, see Page Action Nodes, Keyboard and Wait Nodes, Data Collection and Storage Nodes, Data Processing Nodes, and Flow Control Nodes.

Connect Nodes

Drag from an upstream output port to a downstream input port. After connecting:

  • Each standard output can retain at most one connection.
  • A new connection from the same output replaces the previous one.
  • Double-click a connection to delete it.
  • Drag an endpoint to reconnect an existing connection.
  • Node positions affect layout only; connections determine execution order.

Auto-connect is enabled for new workflows. When a node approaches a compatible position, the editor creates or adjusts a connection according to the detection distance. The default is 150 pixels and can be changed or disabled in Workflow Settings.

The canvas supports:

  • Dragging an empty area to pan.
  • Zooming the workflow view.
  • Fit View to display the complete workflow.
  • Panning and zooming through the minimap.
  • Auto Layout to rearrange nodes in the active layout direction.

For a large workflow, apply Auto Layout first and then fine-tune important branches.

Use the Toolbar

Workflow editor toolbar
Workflow editor toolbar
No.FeatureDescription
1SearchHighlights canvas nodes with matching names; press Enter for the next result
2UndoReverts the most recent edit
3RedoRestores the most recently undone edit
4Auto LayoutRearranges nodes using the horizontal or vertical setting
5GroupPlaces an eligible sequence of nodes in one group
6Import WorkflowReplaces the canvas with JSON; the imported result must still be saved manually
7Export WorkflowExports canvas JSON for the active workflow
8Workflow SettingsChanges layout, Auto-connect, error handling, and runtime options
9Debug LogsOpens logs for the active or most recent debug run
10Debug / StopRuns the active workflow or requests that debugging stop
11SaveValidates and saves, then returns to the workflow list

The editor retains up to 100 history snapshots. Afterward, the oldest edits are discarded.

Keyboard Shortcuts

ShortcutAction
Ctrl/Cmd + SSaves and remains in the editor
Ctrl/Cmd + CCopies one or more selected nodes
Ctrl/Cmd + VPastes copied nodes

When several nodes are copied, connections internal to the selected subgraph are copied as well. External connections to unselected nodes are not.

When the cursor is in a standard input, text area, or JavaScript editor, the workflow editor does not intercept copy and paste shortcuts.

Node Quick Actions

The floating toolbar for a standard node provides:

  • Debug from this node.
  • Copy node.
  • Delete node.
  • Configure error handling.
  • Enable or disable node.

IF and structured loop nodes cannot be disabled. Close Profile is a terminal node that closes the active browser profile and ends the current execution path.

Debug from the Current Node

Node debugging validates only the selected node and its reachable downstream path:

  • Standard nodes before it do not run, so their output variables are unavailable.
  • Global variables from Start are still injected.
  • If it depends on an upstream output, start debugging from an earlier node or prepare a suitable global variable for the test.

Error Handling

A node can Stop Workflow, Skip Current Node, or Run Alternative Actions on error.

Only Run Alternative Actions displays a red error output. Each error output supports one connection, and an error connection does not consume a standard input limit.

Node error-handling branch
Node error-handling branch
StrategyBehaviorSuitable use
Stop WorkflowStops the current execution pathCritical login or pre-payment validation that cannot be skipped
Skip Current NodeRecords the error and continues downstreamNoncritical screenshot or optional field extraction
Run Alternative ActionsEnters a separate branch from the red error outputRecord failure, refresh and retry, or close the profile safely

Condition and Loop Connections

IF Condition

An IF node must connect both True and False; it has no default standard output. Branches can merge later when structurally valid, including nested IF merges.

IF connections
IF connections

Structured Loops

For Each Element, Repeat N Times, For Each Data Item, and While use the same ports:

  • Loop Start: Enters the loop body.
  • Loop End: Returns from the body to the loop node; at least one back edge is required.
  • Default output: Continues after the loop and can remain unconnected.

The main input and Loop Start each allow one connection. If the body contains branches, several branch edges can return to Loop End.

Structured loop connections
Structured loop connections
No.Loop portDescription
1Main inputEnters the loop from an upstream node
2Loop StartStarts an iteration and enters the body
3Loop EndReturns after the body completes
4Default outputContinues the main workflow after the loop finishes

Use Groups

Groups contain a linear sequence of standard operations that execute in order.

Create a Group Manually

Drag standard nodes into a group. Inside it, you can:

  • Change node order.
  • Edit or delete nodes.
  • Stop or skip on a node error.
  • Drag nodes back to the top-level canvas.
  • Ungroup the complete group.

Start, another group, IF, structured loops, and Break Loop cannot be placed in a group.

Dragging a Node into a Group Changes Connections

Dragging a top-level node directly into a group deletes its existing connections. The editor does not reconnect its original predecessor and successor automatically. Review the main flow after grouping.

Group Automatically

Automatic grouping requires at least 3 consecutive, linear standard nodes. It is unavailable when:

  • A node has a custom error branch.
  • A node is inside a standard branch.
  • A node contains a loop back edge.
  • Connections skip across the sequence.

When no nodes are selected, Group attempts to find the longest eligible sequence on the canvas.

Nodes before grouping
Nodes before grouping
Nodes after grouping
Nodes after grouping

Save and Leave

The toolbar Save action validates node fields and workflow graph structure. A successful save returns to the list. Ctrl/Cmd + S saves and remains in the editor.

When unsaved changes exist, leaving provides:

  • Save: Save changes and leave.
  • Discard: Abandon the changes and leave.
  • Cancel: Remain in the editor.

Resolve Validation Errors

Saving, importing, and debugging validate the workflow. The editor highlights and focuses the relevant node and displays the reason.

Common structural errors include:

  • Start is missing or a node is outside an executable path.
  • IF lacks a True or False branch.
  • A loop lacks Loop Start or a back edge to Loop End.
  • A standard node has multiple invalid inputs.
  • Close Profile has a standard outgoing connection.
  • A required node field is empty or an output variable name is invalid.

Fix the first highlighted error and validate again. One structural fault can cause several later messages, so following execution order is usually faster.

Next Steps