The TEXTJOIN function combines the text from multiple ranges and/or strings, and includes a delimiter you specify between each text value that will be combined. If the delimiter is an empty text string, this function will effectively concatenate the ranges.
Note: This feature is available on Windows or Mac if you have Office 2019, or if you have a Microsoft 365 subscription. If you are a Microsoft 365 subscriber, make sure you have the latest version of Office.
Syntax
TEXTJOIN(delimiter, ignore_empty, text1, [text2], …)
argument |
Description |
---|---|
delimiter (required) |
A text string, either empty, or one or more characters enclosed by double quotes, or a reference to a valid text string. If a number is supplied, it will be treated as text. |
ignore_empty (required) |
If TRUE, ignores empty cells. |
text1 (required) |
Text item to be joined. A text string, or array of strings, such as a range of cells. |
[text2, ...] (optional) |
Additional text items to be joined. There can be a maximum of 252 text arguments for the text items, including text1. Each can be a text string, or array of strings, such as a range of cells. |
For example, =TEXTJOIN(" ",TRUE, "The", "sun", "will", "come", "up", "tomorrow.") will return The sun will come up tomorrow.
Remarks
-
If the resulting string exceeds 32767 characters (cell limit), TEXTJOIN returns the #VALUE! error.
Examples
Copy the example data in each of the following tables, and paste it in cell A1 of a new Excel worksheet. For formulas to show results, select them, press F2, and then press Enter. If you need to, you can adjust the column widths to see all the data.
Example 1
Currency |
|
---|---|
US Dollar |
|
Australian Dollar |
|
Chinese Yuan |
|
Hong Kong Dollar |
|
Israeli Shekel |
|
South Korean Won |
|
Russian Ruble |
|
Formula: |
=TEXTJOIN(", ", TRUE, A2:A8) |
Result: |
US Dollar, Australian Dollar, Chinese Yuan, Hong Kong Dollar, Israeli Shekel, South Korean Won, Russian Ruble |
Example 2
A's |
B's |
---|---|
a1 |
b1 |
a2 |
b2 |
a4 |
b4 |
a5 |
b5 |
a6 |
b6 |
a7 |
b7 |
Formula: |
=TEXTJOIN(", ", TRUE, A2:B8) |
Result: |
a1, b1, a2, b2, a4, b4, a5, b5, a6, b6, a7, b7 If ignore_empty=FALSE, the result would be: a1, b1, a2, b2, , , a4, b4, a5, b5, a6, b6, a7, b7 |
Example 3
City |
State |
Postcode |
Country |
---|---|---|---|
Tulsa |
OK |
74133 |
US |
Seattle |
WA |
98109 |
US |
Iselin |
NJ |
08830 |
US |
Fort Lauderdale |
FL |
33309 |
US |
Tempe |
AZ |
85285 |
US |
end |
|||
, |
, |
, |
; |
Formula: |
=TEXTJOIN(A8:D8, TRUE, A2:D7) |
||
Result: |
Tulsa,OK,74133,US;Seattle,WA,98109,US;Iselin,NJ,08830,US;Fort Lauderdale,FL,33309,US;Tempe,AZ,85285,US;end |
Need more help?
You can always ask an expert in the Excel Tech Community or get support in Communities.
See Also
Find and correct errors in formulas
Excel keyboard shortcuts and function keys