Skip to content

=LISTJOIN

The =LISTJOIN() function accepts a semicolon separated list and returns the same list with each entry separated by the specified text. See below for a list of special keywords that can be used as item separators.

=LISTJOIN(NewListItemSeparator; SemicolonSeparatedList)
  • NewListItemSeparator – The text or special keyword to use as a separator between list entries.

  • SemicolonSeparatedList – The semicolon-separated list of text values to join.

  • Loops through each item in the provided list.

  • Inserts the specified separator between each list entry.

  • Returns the new combined list with the chosen separators applied.

  • Formula functions are case sensitive and must be written in ALL CAPS.

  • Special keywords are literal and must be typed exactly as listed (e.g., ppnewline).

  • Can be used to format lists for display, reports, emails, or text files.

=LISTJOIN(ppnewline; ListEntry1; ListEntry2; ListEntry3)

Returns

ListEntry1
ListEntry2
ListEntry3


Any text value can be used as the list separator value. Here are some keywords that can be used to represent special characters.

ppnewline = new line character
pptab = tab character
ppcrlf = carriage return / line feed
ppcr = carriage return
pplf = line feed
ppvtab = vertical tab character
ppsp = space character


LISTJOIN, join list, list separator, string formatting, semicolon-separated list, special characters, workflow formulas, formula function