TEXTJOIN function

This article describes the formula syntax and usage of TEXTJOIN, one of the text functions in Excel.

Note: This feature is only available if you have an Office 365 subscription. If you are an Office 365 subscriber, make sure you have the latest version of Office.

Try Office 365 or the latest version of Excel

Description

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.

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, get support in the Answers community, or suggest a new feature or improvement on Excel User Voice.

See Also

CONCATENATE function

CONCAT function

Overview of formulas in Excel

How to avoid broken formulas

Find and correct errors in formulas

Excel keyboard shortcuts and function keys

Text functions (reference)

Excel functions (alphabetical)

Excel functions (by category)

Expand your skills
Explore training
Get new features first
Join Office Insiders

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×