1. Home
  2. Functions
  3. Text
  4. JOIN

JOIN function

Joins values and ranges with a delimiter between them.

Syntax

=JOIN(delimiter, value_or_array1, [value_or_array2], ...)

Arguments

ArgumentRequiredDescription
delimiterRequiredText to put between the values
value_or_array1RequiredA value or range
value_or_array2OptionalMore values or ranges

How to use JOIN

JOIN takes 2 required arguments and 1 optional argument, and accepts more values in the same pattern. Type =JOIN( in a cell and SheetsBat shows the arguments as you go. Optional arguments are shown in square brackets; leave them out to use their default.

Examples

Each result below was calculated by the SheetsBat formula engine.

=JOIN("-", 1, 2, 3)Result "1-2-3"
=JOIN(", ", {"a","b","c"})Result "a, b, c"

Every formula, right in your browser

SheetsBat calculates 536 functions, with charts, pivot tables and live collaboration. Free to start.