Batch Node

Loading node sections...

Overview

The Batch Node is similar to the Loop (for loop) Node: it iterates over a List or a Range. The key difference is that Batch runs iterations in parallel, and you can control throughput using a Concurrency Limit.

Node Type Information

Type	Description	Status
Batch Trigger	Starts the flow on a schedule or batch event. Ideal for periodic data processing.	❌ False
Event Trigger	Starts the flow based on external events (e.g., webhook, user interaction).	❌ False
Action	Executes a task or logic as part of the flow (e.g., API call, transformation).	✅ True

This node is an **Action** node that iterates over a list or range and executes iterations in parallel with a configurable concurrency limit.

Use Batch when you want faster processing (parallelism). Use Loop when you need strict ordering or sequential dependencies between iterations.

Features

Key Functionalities

Range-based batching: Iterate over numeric ranges using initial, end, and increment values.
List-based batching: Iterate over arrays/collections for flexible parallel processing.
Concurrency control: Cap parallel executions with a concurrency limit (1–50) to protect rate limits and downstream systems.

Benefits

Higher throughput: Process items faster by running multiple iterations at once.
Safer scaling: Control load using concurrency limits instead of “all at once”.
Flexible iteration: Works with both structured lists and numeric ranges.

What Can You Build?

Parallel web/page processing: Run multiple scrapes or fetches concurrently.
Fan-out API calls: Enrich many records by calling a third-party API with controlled concurrency.
Batch content generation: Generate summaries/embeddings for many inputs in parallel while staying under model or token rate limits.

Setup

Add the Batch Node to your flow.
Choose Iterate Over as List or Range.
Configure the required fields (marked with *).
Set a Concurrency Limit based on your downstream limits (API rate limits, model throughput, etc.).
Deploy the project.

Configuration Reference

Parameter	Required	Description	Example Value
Iterate Over	Yes*	Select `List` or `Range`. If `List`, provide the list/array to iterate over.	`{{triggerNode_1.output.urls}}` or `Range`
Initial Value	Range only*	Starting value of the batch range.	`0`
End Value	Range only*	Ending value of the batch range (exclusive).	`10`
Increment	Range only*	Step size for each iteration.	`1`
Concurrency Limit	Yes*	Maximum number of parallel executions (min: 1, max: 50).	`10`

Low-Code Example

Iterate over a list (parallel)

nodes:
  - nodeId: batchNode_692
    nodeType: batchNode
    nodeName: Batch
    values:
      endValue: 10
      increment: 1
      connectedTo: batchEndNode_757
      iterateOver: list
      initialValue: '1'
      iteratorValue: '[]'
      concurrencyLimit: '2'
    modes: {}

Iterate over a range (parallel)

nodes:
  - nodeId: batchNode_692
    nodeType: batchNode
    nodeName: Batch
    values:
      endValue: 10
      increment: 1
      connectedTo: batchEndNode_757
      iterateOver: range
      initialValue: '1'
      iteratorValue: '[]'
      concurrencyLimit: '2'
    modes: {}

Output

The output from the Batch Node is an array containing the outcome of each iteration.

Troubleshooting

Common Issues

Problem	Solution
Rate limit / 429 errors	Lower Concurrency Limit and/or add retry/backoff downstream.
Downstream overload (timeouts, failures)	Reduce concurrency, or batch into smaller lists/ranges.
Unexpected iteration values	Double-check `Initial Value`, `End Value` (exclusive), and `Increment` (step).

Debugging Tips

Start with a low concurrency (e.g., 2–5) and increase gradually.
Use flow logs to identify which iteration(s) fail and why.
If you’re batching API calls, align concurrency with the API’s published limits.

By leveraging the Lamatic.ai Batch Node, you can process lists and ranges quickly while keeping resource usage controlled.