Universal Item Iteration — BizFirstAI Flow Studio

Process Items at Scale

Send 10,000 emails, call 1,000 APIs, or insert 100,000 database records—all with a single node configuration.

Configuration Properties

Supported Node Types

100×

Potential Speedup (Parallel)

∞

Item Count Limit

Get Started in 3 Steps

Enable iteration: Set itemsIterationEnabled: true
Specify items: Tell the node which array to iterate (property name, formula, or JSONPath)
Access current item: Use @{input:item} in your configuration

Built-in Batching

Process items in batches for efficiency. Configure batch size from 1 to 1,000+.

Parallel Execution

Process multiple items concurrently. 10× to 100× speedup for I/O-bound operations.

Error Handling

Automatic retries, configurable failure modes, and detailed error reporting.

Filter & Sort

Filter items before iteration and sort by any expression.

Rate Limiting

Control speed with batch wait times. Respect API and system limits.

Multi-Node Support

Works with SMTP, HTTP, DataMapping, Database, and Custom nodes.

Supported Node Types

Node Type	Typical Use	Batch Support	Parallel Support
SMTP/EmailSmtp	Send bulk emails	✓	✓
HTTP Request	Parallel API calls	✓	✓
DataMapping	Transform items	✓	✓
Database	Bulk insert/update	✓	✗
Custom	Any custom logic	✓	✓

Documentation

Overview What is Universal Iteration? When to use it? Getting Started Build your first iteration in 5 minutes Configuration Complete reference for 21 properties Batching & Performance Optimize for speed and efficiency Variable Access Access current item and iteration data Error Handling Strategies for failure recovery Best Practices Design patterns and real-world lessons vs. Loop Node When to use each approach

Real-World Use Cases

Bulk Email Campaign

Send personalized emails to 50,000 customers with parallel batching.

SMTP Node

Parallel API Calls

Fetch data from external API for 1,000 users concurrently.

HTTP Request

Bulk Database Insert

Insert 100,000 records into database in batches of 500.

Database Node

Data Transformation

Transform and enrich 10,000 records in parallel.

DataMapping Node

Payment Processing

Charge 1,000 customers with automatic retry on failure.

HTTP Request

Webhook Delivery

Deliver webhooks to 10,000 subscribers with rate limiting.

HTTP Request

Ticket Processing

Process and categorize 5,000 support tickets per run.

Custom Node

Image Processing

Resize and optimize 10,000 images in parallel.

Custom Node

Universal Iteration vs. Loop Node

Feature	Universal Iteration	Loop Node
Single-node operations	✓ Perfect	✓ Works
Multi-node workflows	✗ Not supported	✓ Built for this
Setup time	2 minutes	10 minutes
Built-in batching	✓ Advanced	✓ Basic
Parallel execution	✓ Yes	✓ Yes
Conditional branching	✗ No	✓ Yes
Variable isolation	⚠️ Limited	✓ Full

See detailed comparison →

Quick Examples

Example 1: Send Emails to Multiple Recipients

{
  "itemsIterationEnabled": true,
  "itemsIterationPropertyName": "customers",
  "recipients": "@{input:item|email}",
  "subject": "Hello @{input:item|name}!",
  "body": "This is a personalized message for @{input:item|name}"
}

Example 2: Parallel API Calls with Rate Limiting

{
  "itemsIterationEnabled": true,
  "itemsIterationPropertyName": "user_ids",
  "url": "https://api.example.com/users/@{input:item|id}",
  "method": "GET",
  "batchSize": 10,
  "parallelExecution": true,
  "batchWaitTimeMs": 500
}

Example 3: Bulk Insert with Error Handling

{
  "itemsIterationEnabled": true,
  "itemsIterationPropertyName": "records",
  "batchSize": 500,
  "breakOnFirstError": false,
  "retryFailedItems": 2,
  "filterExpression": "@{input:item|is_valid}==true"
}