WorqHat
Process Nodes

Loop Process

Category
Logic & Control Flow
Node Type
Iterative Process

Overview

The Loop Process Node is used to repeat a set of actions several times inside your workflow. It helps you run the same task automatically for a fixed number of iterations or items, without needing to manually duplicate steps.

This node is helpful when you need to process multiple records, perform repetitive operations, or create batch tasks — such as sending several messages, checking multiple values, or looping through a list of data.

Description

Automate repetitive tasks.

The Loop Process Node works by running a group of connected actions in a loop. You can define a loop variable that represents the current iteration (like a or i), and you can specify how many times the loop should run by setting a maximum iteration count.

Fixed Iteration

Run a specific number of times (e.g., 10 times).

Batch Processing

Process groups of items efficiently in sequence.

Each time the loop runs, the workflow uses the loop variable’s value for that round. Once it finishes all the iterations, the loop stops automatically.

Input Parameters

The Loop Process node accepts settings to define the loop behavior.

Loop VariablestringRequired
The name of the variable used in each loop iteration (e.g., 'item' or 'i').
Example
"item"
Maximum IterationsnumberRequired
The total number of times the loop should repeat.
Example
10
Node DescriptionstringOptional
An optional text description explaining what this loop is designed to do.
Example
"Process user list"

Output Parameters

The node provides a summary of the execution.

conditionbooleanOptional
Indicates whether the loop ran successfully or not.
Example
true
totalIterationsnumberOptional
Shows how many total iterations were planned for this loop.
Example
10
completedIterationsnumberOptional
Displays how many times the loop actually completed its actions.
Example
10
batchesProcessednumberOptional
If your workflow runs items in groups, this value shows how many batches were processed.
Example
1
Loop Variable OutputanyOptional
Shows the final value of the loop variable after all iterations are complete.

Output Type

Output Type: Iterative Data

The output includes numeric results such as how many iterations were completed and the final state of your loop variable. You can use this information in later steps of your workflow.

Example Usage

Example 1: Simple 10-Iteration Loop

Run a task 10 times.

{  "loopVariable": "a",  "maximumIterations": 10}
{  "totalIterations": 10,  "completedIterations": 10,  "batchesProcessed": 1,  "a": null}

Example 2: Process Multiple Items

Loop through 5 items.

{  "loopVariable": "item",  "maximumIterations": 5}
{  "totalIterations": 5,  "completedIterations": 5,  "batchesProcessed": 1,  "item": "last_processed_value"}

How to Use in a No-Code Workflow

1

Add the Node

Drag and drop the Loop Process Node into your workflow canvas.

2

Set Variable

Enter a name for your Loop Variable (like item or a). This represents the current count or item.

3

Set Limit

Specify the Maximum Iterations to ensure the loop stops after the desired number of rounds.

4

Add Actions

Place the nodes or actions that you want to repeat inside the loop.

5

Run Workflow

Execute the workflow to see the loop in action.

Best Practices

  • Always set a maximum iteration limit to avoid infinite loops.
  • Start with a small number of iterations (like 3 to 5) during testing.
  • Give your loop variable a short, meaningful name that reflects its purpose.

Do / Don’t

Do
  • ✔️ Combine with If/Else Conditions for smarter decision-making inside loops.
  • ✔️ Use for batch operations like sending multiple messages.
  • ✔️ Ensure data flows correctly into the loop from previous nodes.
Don’t
  • ❌ Don’t leave the loop variable blank.
  • ❌ Don’t forget to connect the "Next Step" after the loop finishes.
  • ❌ Don’t expect a return loop inside another loop to execute (nested returns are complex).

Common Errors

Loop variable not definedErrorOptional
The loop variable field was left blank. Provide a name like 'item'.
Maximum iterations missingErrorOptional
You must set the total number of iterations to prevent infinite loops.
No actions insideWarningOptional
The node has nothing to process. Add at least one action inside.
Loop did not startErrorOptional
Input data was empty or invalid. Check previous node output.

Example Workflow Integration

Use Case 1: Send Personalized Emails

Send an email to 10 users.

  1. Trigger: User List Loaded.
  2. Loop Process: Variable user, Max Iterations 10.
  3. Send Email (Inside Loop): Send message to current user.
  4. Summary: Log "All messages sent".

Workflow Data Flow:

{{user.email}} →  {{sendEmail.to}}

Use Case 2: Batch Data Processing

Update status for 50 records.

  1. Fetch Data: Get 50 records.
  2. Loop Process: Variable record, Max Iterations 50.
  3. Update Data (Inside Loop): Set status to "Processed".

Workflow Data Flow:

{{record.id}}    →  {{updateData.query.id}}