WorqHat
Utility

Handle Variable

Category
Data Management
Node Type
Variable Node

Overview

The Handle Variable node helps you store and manage values (like numbers, text, or data) that you want to use in different parts of your workflow. It makes your workflow smarter by allowing you to remember and reuse information without writing code.

Description

Store and reuse data.

The Handle Variable node is like a small memory box inside your workflow. You can give the box a name and put some information inside it.

Store Values

Save numbers, text, or file names for later.

Reuse Data

Access stored values in any downstream node.

For example, create a variable named price with value 500, and use {{price}} later in a calculator or message node.

Input Parameters

Define the variable to store.

Variable NamestringRequired
The name to refer to this variable later.
Example
"price"
Variable ValueanyRequired
The value to store (number, text, etc.).
Example
500
Node DescriptionstringOptional
Optional note about usage.

Output Parameters

The node confirms the storage.

[variableName]anyOptional
Returns the stored value keyed by the variable name.
Example
{ "price": 500 }

Output Type

Output Type: JSON

The result is saved in JSON format, showing the variable name and its value.

Example Usage

Example 1: Store a Price

Save a product price.

{  "Variable Name": "price",  "Variable Value": 500}
{  "price": 500}

Example 2: Store a Filename

Save an uploaded file name.

{  "Variable Name": "filename",  "Variable Value": "report.pdf"}
{  "filename": "report.pdf"}

How to Use in a No-Code Workflow

1

Add the Node

Drag the Handle Variable node into your workflow.

2

Set Name

Type the Variable Name (e.g., price).

3

Set Value

Enter the Variable Value you want to store.

4

Reuse

Use {{variable_name}} in any subsequent node to access the value.

Best Practices

  • Use clear names like totalAmount or customerName.
  • Initialize variables near the start of the workflow.

Do / Don’t

Do
  • ✔️ Keep data types consistent.
  • ✔️ Use variables to pass data across long workflows.
Don’t
  • ❌ Don’t reuse names unless you intend to overwrite.
  • ❌ Don’t use special characters in variable names.

Common Errors

Variable not foundErrorOptional
Node must be executed before use.
Overwriting valuesWarningOptional
Using the same name replaces the old value.

Example Workflow Integration

Use Case: Store Global Config

Define settings once and use them throughout the workflow.

  1. Start: Workflow begins.
  2. Handle Variable: Store taxRate = 0.15.
  3. Calculate Total: Use {{taxRate}} in multiple calculation nodes.

Workflow Data Flow:

0.15 → {{handleVariable.taxRate}}
{{handleVariable.taxRate}} → {{calcNode.multiplier}}