Skip to main content

Join Text List

Uncontrolled node

Overview

The Join Text List node combines all elements of a text array into a single string, inserting a specified separator between each element. This is useful for concatenating lists of words, sentences, or data rows into a single text output.

For example, joining the list ["Hello", "world"] with a space separator produces "Hello world".

Inputs

InputTypeDescriptionDefault
ListArrayThe list of text items to join together.-
SeparatorTextThe string to insert between each element in the list.Empty string ("")

Outputs

OutputTypeDescription
OutputTextThe concatenated string with separators inserted between elements.

Runtime Behavior and Defaults

This is an uncontrolled node, meaning it executes automatically whenever its inputs change without requiring an event trigger.

  • Empty List Handling: If the input list is empty or not a valid array, the node returns an empty string.
  • Separator Handling: If the separator is not provided or is not a string type, it defaults to an empty string (elements are concatenated directly with no delimiter).
  • Type Coercion: Non-string elements in the list are converted to strings during the join operation.

Example Usage

Scenario: Combining a list of words into a sentence.

  1. Create a List node containing ["The", "quick", "brown", "fox"]
  2. Connect the List output to the Join Text List node's list input
  3. Set the separator input to a single space: " "
  4. The output will contain: "The quick brown fox"

Scenario: Creating a comma-separated values (CSV) line from data.

  1. Provide a list of values: ["apple", "banana", "cherry"]
  2. Set the separator to: ", "
  3. The output will contain: "apple, banana, cherry"