Node States

Understand node status indicators and what they mean

Node States

What are Node States?

Each node has a state that indicates its current condition. Understanding these states helps you monitor your workflow and identify issues during execution.

State Indicators

States are shown visually with different colors on the node. Here's what each color means:

Idle (Gray)

Color: Gray or neutral

Meaning: The node is inactive and not executing. This is the default state when the workflow is not running.

Ready (Blue)

Color: Light Blue

Meaning: The node is ready to execute. All its input requirements are met and it's waiting for execution to begin.

Running (Orange/Yellow)

Color: Orange or Yellow

Meaning: The node is currently executing. Its process is active and working on the input data.

Success (Green)

Color: Green

Meaning: The node executed successfully and produced output without errors.

Error (Red)

Color: Red

Meaning: An error occurred while executing this node. The workflow should stop or this node should fail.

Tip: Hover your mouse over a red node to see a tooltip with the error details.

Disabled (Striped)

Color: Gray with stripes

Meaning: The node is disabled and will not execute.

Pending (Dashed Border)

Color: Dashed outline

Meaning: The node is waiting for input from other nodes before it can execute.

State Transitions During Execution

Here's the typical flow of states during a single execution:

Status Badge Icons

Some nodes display additional status icons:

Understanding Execution Flow Through States

Example 1: Simple Two-Node Workflow

  1. Node A and B are connected: A output → B input
  2. Click Execute
  3. Node A: Idle → Ready → Running → Success (Green)
  4. Node B: Idle → Pending → Ready → Running → Success (Green)
  5. Both execute sequentially based on their dependency

Example 2: Three-Node Parallel Execution

  1. Node A has outputs connecting to Both B and C (no connection between B-C)
  2. Click Execute
  3. Node A executes first
  4. Nodes B and C both go Ready → Running simultaneously
  5. All reach Success (Green) when complete
Tip: Watch the state colors change during execution to understand the flow of your workflow. This visual feedback is very helpful for learning.

Troubleshooting Based on Node States

State Problem Solution
Red (Error) Node execution failed Check console, verify inputs are valid
Pending (not executing) Node won't execute Check if dependent nodes have errors
Disabled (Striped) Node is being skipped Right-click node and enable it
Gray (Idle) Workflow never runs Click Execute button, check if nodes have errors