Iterator Node

Iterator Node

Module ID: ion.action.iterator

The Iterator node takes an array and outputs each item individually, enabling parallel or sequential processing of list data.

---

Overview

Use the Iterator node when you need to process each item in an array separately. Each item is emitted as a separate output, allowing downstream nodes to handle them independently.

---

Handles

Input

Handle	Description
input	Array of items to iterate

Outputs

Handle	Description
output	Each item from the array (emitted multiple times)
error	Input is not a valid array

---

Configuration

The Iterator node requires no additional configuration. The array to iterate comes directly from the node’s data property.

// node.data is the array to iterate
node.data = [item1, item2, item3, ...]

---

Behavior

1. Receives array data
2. Validates input is an array
3. For each item in the array:
   • Emits the item to the output handle
4. All items are processed before moving to next flow step

graph LR
  A[Array Input] --> B[Iterator]
  B -->|item 1| C[Process]
  B -->|item 2| C
  B -->|item 3| C
  C --> D[Continue]

Tip

The Iterator creates multiple parallel execution paths. Each item is processed independently.

---

Example

Processing Order Items

Input data:

{
  "items": [
    { "sku": "ABC123", "quantity": 2 },
    { "sku": "DEF456", "quantity": 1 },
    { "sku": "GHI789", "quantity": 5 }
  ]
}

The Iterator outputs each item separately:

Output 1:

{ "sku": "ABC123", "quantity": 2 }

Output 2:

{ "sku": "DEF456", "quantity": 1 }

Output 3:

{ "sku": "GHI789", "quantity": 5 }

---

Common Patterns

Process Each Order Line

[Get Orders] → [Iterator] → [Update Inventory] → [Complete]

Send Multiple Notifications

[Get Recipients] → [Iterator] → [Send Email] → [Log]

---

Error Cases

Error	Cause
”Error Unmarshalling to iterate”	Input is string but not valid JSON array
”There is no data to iterate”	Input is null, empty, or not an array

Caution

Make sure the input is an array. Objects or primitive values will cause an error.

---

See Also

• Condition Node - For conditional branching
• Flow Nodes Overview