Skip to main content

The On Error node

The On Error node is a workflow-level error catcher. Add one per workflow and leave it disconnected from your main flow; the nodes you wire after it form a recovery path that is excluded from normal runs. When any node fails and stops the run, the On Error node executes with the failure details as its output, and its downstream path runs. Use it for Slack alerts, error emails, or logging. Its output carries:
FieldWhat it is
errorThe error message
workflow_idThe workflow that failed
execution_idThe failed run’s ID
nodes_executedHow many nodes completed before the failure
durationRun duration in seconds
Reference these downstream, e.g. a Slack message with Workflow failed: {{on-error-id.error}}.

Per-node failure settings

Every node also has a Settings view in its config panel with failure controls:
SettingWhat it does
Retry on FailRe-run the node on failure. Max Tries up to 5, with a configurable Wait Between Tries (ms).
On ErrorWhat happens after the final failed attempt (below)
The On Error options:
  • Stop Workflow (default): the run fails. The On Error node fires if present.
  • Continue (Regular Output): the node is treated as succeeded with an empty output and the run continues.
  • Continue (Error Output): the node outputs {error, error_type} and the run continues. If you wire an edge from the node’s error handle, failures route down that path instead of the normal one.
Example: an HTTP request with Retry on Fail (3 tries) and Continue (Error Output), whose error handle feeds a fallback notification while the success path continues unaffected.

Next steps