This document explains the Combine Text node, which merges multiple text values using a customizable template format.

Node Inputs

Required Fields

  • Format: A template that defines how text values should be combined

    Example: “Hello {Name}, your order total is {Total}!”

Dynamic Values

  • Any connected node’s outputs can be used in your format
  • Select values by clicking on the format field and choosing from available outputs
  • Reference values using input badges

Node Output

  • Combined Text: The final merged result with all placeholders replaced by their values

Node Functionality

The Combine Text node:

  • Merges text values from connected nodes
  • Uses simple template-based formatting with placeholders
  • Allows direct selection of values from connected nodes
  • Preserves spaces and punctuation
  • Works with both single values and lists (Loop Mode)

How To Use

  1. Connect Source Nodes: Link previous nodes that contain the values you want to combine
  2. Create Your Template: Click inside the format field and:
    • Type your text template
    • Add placeholders by selecting from available connected values
    • Format as needed with spaces, punctuation, and line breaks
  3. Run Your Flow: The node will replace all placeholders with their corresponding values

Common Use Cases

1. Personalized Messages

Format: "Dear {Customer Name}, thank you for your purchase of {Product}. Your order #{Order Number} will be shipped to {Shipping Address}."

Result: "Dear Alex Smith, thank you for your purchase of Premium Plan. Your order #12345 will be shipped to 123 Main St, New York."

2. Document Headers

Format: "REPORT: {Report Type}\nDate: {Current Date}\nPrepared by: {Author Name}"

Result: "REPORT: Q1 Financial Summary
Date: March 31, 2025
Prepared by: Finance Team"

3. Data Formatting

Format: "{Company Name} ({Industry})\nFounded: {Year}\nEmployees: {Employee Count}\nRevenue: {Annual Revenue}"

Result: "Acme Corporation (Technology)
Founded: 2010
Employees: 250
Revenue: $25M"

4. URL Construction

Format: "https://api.example.com/v1/{Endpoint}?key={API Key}&query={Search Term}"

Result: "https://api.example.com/v1/search?key=abcd1234&query=automation%20tools"

5. SQL Query Building

Format: "SELECT * FROM {Table Name} WHERE {Column} = '{Value}' LIMIT {Limit};"

Result: "SELECT * FROM customers WHERE region = 'Northeast' LIMIT 100;"

Format Tips

1. Basic Text Combination

Combine text with proper spacing:

Format: "{Title} {First Name} {Last Name}"

Result: "Mr. John Smith"

2. Custom Separators

Add separators between values:

Format: "{Company Name} - {Industry} - {Location}"

Result: "Acme Corporation - Technology - New York"

3. Repeated Values

Use the same value multiple times:

Format: "{Customer Name} purchased {Product}. Please deliver to {Customer Name}."

Result: "John Smith purchased Premium Plan. Please deliver to John Smith."

Loop Mode

When the Combine Text node runs in Loop Mode:

  • It processes each item in input lists independently
  • Input lists must be the same length
  • Results in a list of combined strings

Loop Mode Example

Connected values:
- Names: ["John", "Sarah", "Miguel"]
- Scores: ["85", "92", "78"]

Format: "{Names} scored {Scores}%"

Result: ["John scored 85%", "Sarah scored 92%", "Miguel scored 78%"]

In summary, the Combine Text node is a versatile tool for merging values from connected nodes into formatted text, supporting everything from simple concatenation to complex template-based formatting.