Skip to main content

Text Join

The Text Join node combines multiple text inputs into a single output. It's a powerful utility for concatenating text from different sources, building complex prompts, assembling messages, or merging data before passing it to other nodes. With support for multiple input handles, this node enables flexible text composition in your workflows.

Text Join

Basic Usage​

Use the Text Join node to combine multiple text inputs from different nodes (Text nodes, user inputs, AI outputs, etc.) into a single concatenated output.

Inputs​

The Text Join node accepts multiple text inputs through dynamically created input handles.

Input Handles (Green Ports)​

Multiple Text Inputs: Each green input port accepts text from a connected node.

  • Default: Two input handles are provided initially
  • Add More: Click "+ Add handle" to create additional input slots
  • Remove: Click the red trash icon (🗑️) next to an input to remove it
  • Order Matters: Inputs are joined in top-to-bottom order as they appear
  • Optional: Not all inputs need to be connected (empty inputs are skipped)

Outputs​

Output (Green Port)​

Joined Text: Outputs all connected inputs concatenated together.

  • Combines all input texts in order (top to bottom)
  • Empty or unconnected inputs are ignored
  • No separator added between texts (texts are directly concatenated)
  • Can be connected to any node accepting text input

Configuration​

Add Handle Button​

"+ Add handle": Green button to add additional input slots.

How to Use:

  1. Click the "+ Add handle" button
  2. A new input port appears below existing inputs
  3. Connect text sources to the new input
  4. Add as many inputs as needed

Remove Handle​

Delete Icon (🗑️): Red trash icon next to each input handle.

How to Use:

  1. Click the trash icon next to an input you want to remove
  2. The input handle is deleted
  3. Remaining inputs shift up
  4. Connections are removed when handle is deleted

Input Order​

Inputs are joined in the order they appear from top to bottom:

  • First input (top) appears first in output
  • Second input appears next
  • Third input follows
  • And so on...

Example Workflows​

Combining Multiple Text Sources​

Scenario: Combine text from multiple Text nodes to create a comprehensive prompt for an AI node.

Text Join Example

Steps to Create the Flow:

  1. Add a Start Node.

  2. Add two Text nodes with different content:

    Text Node 1:

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. 
    Praesent rutrum, massa vel feugiat scelerisque, ipsum elit...

    Text Node 2:

    Aenean commodo tempor malesuada. Quisque fringilla 
    hendrerit finibus. Curabitur urna mi, semper dapibus...

  3. Add a Text Join node:

    i. Connect the first Text node:

    • Text Node 1 Output (green) → Text Join first input (green)

    ii. Connect the second Text node:

    • Text Node 2 Output (green) → Text Join second input (green)

    iii. Add more inputs if needed:

    • Click "+ Add handle" for additional inputs
    • Remove unwanted inputs with trash icon

  4. Add a Display Text node to show the combined result:

    • Text Join Output (green) → Display Text Input (green)

  5. Connect flow control:

    • Start → Text Join (red to red)
    • Text Join → Display Text (red to red)

Preview:

[Start] → [Text Join]
              ↑ Input 1: Text Node 1
              ↑ Input 2: Text Node 2
       → [Display Text: Shows combined text]

Result: The Display Text node shows both text blocks concatenated together:

Lorem ipsum dolor sit amet, consectetur adipiscing elit. 
Praesent rutrum, massa vel feugiat scelerisque, ipsum elit...
Aenean commodo tempor malesuada. Quisque fringilla 
hendrerit finibus. Curabitur urna mi, semper dapibus...
  • Text: Provides static text inputs to Text Join
  • Create Text Label: Creates variables to be joined with static text
  • Display Text: Shows the joined result to users
  • AI General Prompt: Receives joined text as prompts or instructions
  • API Call: Receives joined URLs, headers, or payloads
  • Web Search: Receives joined search queries
  • Document Download: Generates documents from joined content

Comparison with Similar Approaches​

ApproachText JoinSingle Text NodeFormula/Expression
Multiple Sources✓ Excellent✗ Not possible○ Limited
Dynamic Content✓ Yes○ Static only✓ Yes
Ease of Use✓ Simple✓ Simple○ More complex
Modularity✓ High✗ Low○ Medium
Best ForCombining inputsStatic contentCalculations

Best Practices Summary​

✓ Do:

  • Order inputs logically (top to bottom)
  • Add spacing or separators in text inputs
  • Remove unused handles
  • Test joined output before using
  • Use descriptive node names
  • Keep input count manageable
  • Document complex joins

✗ Don't:

  • Forget spacing between texts
  • Add excessive unused handles
  • Connect to wrong port colors
  • Mix up input order
  • Leave inputs empty unintentionally
  • Overcomplicate simple concatenations

Summary​

The Text Join node is an essential utility for text composition:

✓ Flexible: Support for multiple dynamic inputs
✓ Simple: Easy to add, remove, and arrange inputs
✓ Fast: Instant concatenation with no processing overhead
✓ Versatile: Works with any text source
✓ Organized: Maintains clear input order

Master Text Join to create modular, maintainable workflows with clean text composition and assembly capabilities.