Variables & data

In EzFlow, data travels through a Workflow along variable edges — the typed connections you draw between node handles. Each edge carries the output of one node into the input of the next. Understanding how edges work, and how to reference their values in configuration fields, is the key to building useful automations.

How variable edges work

Every node exposes one or more output handles (on the right side of the card) and input handles (on the left side). When you draw an edge from an output handle to an input handle, EzFlow checks that the two handles share the same data type before accepting the connection.

Data types include values such as strings, numbers, and objects. Conditional nodes also produce branch outputs, which route execution down one path or another rather than carrying a data value.

The edge colour reflects the data type flowing through it — each type has a distinct colour so you can trace data paths at a glance.

Referencing values in configuration

Inside a node's configuration modal, you can reference the value arriving on an input handle using the expression syntax:

{{data.fieldName}}

For example, if an HTTP Trigger receives this JSON body:

{ "phone": "+15550001234", "name": "Acme" }

A downstream Send WhatsApp node can use {{data.phone}} in its To field to send to the number that arrived with the trigger. The Quickstart walks through a complete example of this pattern.

Nested fields follow the same dot-notation path: {{data.address.city}} reaches a nested property.

Connection rules

EzFlow enforces type safety at connection time:

A string output can only connect to a string input.
An object output connects to an object input.
A branch output (from conditional nodes) connects to the special branch input on the next node, routing execution rather than passing data.

If the types do not match, the canvas rejects the connection. When a node's configuration changes its output type, EzFlow recalculates downstream handles and removes any edges that are no longer valid.

Defining workflow variables

In addition to data flowing through edges, you can define named variables for a Workflow using the Variables configuration panel. Variables you define here are available by name inside any node configuration in the Workflow.

To manage variables, open the Variables panel from within the canvas (the exact access point depends on your canvas toolbar). You can add fields with the + button, delete them in deletion mode, and save when done.

Practical tips

Keep edge types consistent as you design the graph — adding a type mismatch between two nodes removes the connecting edge automatically.
Use the Mapper node to reshape or rename fields before passing data to a node that expects a different structure.
If a value you need is nested or requires transformation, the Script node lets you write TypeScript to produce any output shape you need.

Connections — the conceptual model for how edges carry data.
Configuring nodes — where you enter expressions like {{data.x}}.