Flows/Utilities/Iterators/Text Aggregator

Text Aggregator

Consolidate multiple bundles into a single text output

Overview

The Text Aggregator utility collects text values from multiple bundles and concatenates them into a single string output. This is useful for building documents, combining messages, or creating formatted text from individual pieces.

Unlike Array Aggregator which creates an array, Text Aggregator joins values with a customizable separator into a single text string.

Configuration

Source Module

Required. Select which iterator's bundles to aggregate. This links the aggregator to a specific iteration context.

Text

Required. Template to evaluate for each bundle. The resolved text from each bundle is collected and joined together.

{{#3.name}}: {{#3.email}}

Default: {{$}} - captures entire bundle.

Row Separator

Select how to join the text from each bundle:

Newline- Joins with \n

Space- Joins with single space

Comma- Joins with ,

Custom- Joins with custom separator you define

Custom Separator

When Row Separator is set to "Custom", enter your custom separator string.

|

Output

Outputs a single bundle with the concatenated text:

Output field:

text - The combined text string with separators

Example output:

// With text: "{{#2.name}}: {{#2.email}}"
// Row Separator: Custom, Custom Separator: " | "

// Output:
{
  text: "John: john@example.com | Jane: jane@example.com | Bob: bob@example.com"
}

Examples

Example 1: Build Email List

Create a formatted list of names and emails from user data:

Source Module:Iterator (#2)

Text:{{#3.name}} <{{#3.email}}>

Row Separator:Newline

Output: John <john@example.com>\nJane <jane@example.com>

Example 2: Create CSV Values

Combine values into comma-separated format:

Text:{{#2.value}}

Row Separator:Comma

From array ["John", "Doe", "john@example.com"]
Output: John, Doe, john@example.com

Example 3: Custom Separator

Use a custom separator to join product names:

Text:{{#3.productName}}

Row Separator:Custom

Custom Sep: |

Output: Product A | Product B | Product C

Tips

Tip: Choose the appropriate Row Separator for your use case. Use "Newline" for multi-line text, "Comma" for lists, or "Custom" for special formats.

Tip: Use {{#N.text.length}} in downstream nodes if you need to check the character count.

Note: If a template fails to resolve for a bundle, an empty string is added to maintain the correct bundle count.

Array Aggregator Loop