elasticsearch/docs/reference/esql/functions/mv_concat.asciidoc

[discrete]
[[esql-mv_concat]]
=== `MV_CONCAT`

*Syntax*

[.text-center]
image::esql/functions/signature/mv_concat.svg[Embedded,opts=inline]

*Parameters*

`v`::
Multivalue expression.

`delim`::
Delimiter.

*Description*

Converts a multivalued string expression into a single valued column containing
the concatenation of all values separated by a delimiter.

include::types/mv_concat.asciidoc[]

*Examples*

[source.merge.styled,esql]
----
include::{esql-specs}/string.csv-spec[tag=mv_concat]
----
[%header.monospaced.styled,format=dsv,separator=|]
|===
include::{esql-specs}/string.csv-spec[tag=mv_concat-result]
|===

To concat non-string columns, call <<esql-to_string>> first:

[source.merge.styled,esql]
----
include::{esql-specs}/string.csv-spec[tag=mv_concat-to_string]
----
[%header.monospaced.styled,format=dsv,separator=|]
|===
include::{esql-specs}/string.csv-spec[tag=mv_concat-to_string-result]
|===