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"