ReferenceFunctionsText Functions
TEXTJOIN
TEXTJOIN: Joins text values using a delimiter, with optional empty-value filtering.
Summary
TEXTJOIN(delimiter, ignore_empty, text1, ...) is useful for building labels and lists.
Remarks
ignore_empty=TRUEskips empty strings and empty cells.ignore_empty=FALSEincludes empty items, which can produce adjacent delimiters.- Text ranges and arrays are flattened in row-major order.
- Delimiter and values are coerced to text.
- Any error in inputs propagates immediately.
- Results longer than 32,767 characters return
#VALUE!.
Examples
Ignore empty entries
Grid
| Cell | Value | |
|---|---|---|
| No inputs on Sheet1. | ||
Formula
=
Result
Not evaluated yet.
Expected
a,c
Related functions
FAQ
What does ignore_empty change?
TRUE skips empty values; FALSE keeps them, which can create adjacent delimiters.
Runtime metadata
Category
Text
Signature
TEXTJOIN(arg1: Any, arg2: Any, arg3…: Any (Range))Arity
min 3, max variadic
Arguments
arg1Any · Scalar
arg2Any · Scalar
arg3repeating 1Any · Range
Caps
PURE
Source