---
title: ES|QL MV_APPEND function
description: 
url: https://www.elastic.co/elastic/docs-builder/docs/3608/reference/query-languages/esql/functions-operators/mv-functions/mv_append
products:
  - Elasticsearch
---

# ES|QL MV_APPEND function
Appends two multi-value fields together.

## Syntax

![Embedded](https://www.elastic.co/elastic/docs-builder/docs/3608/reference/query-languages/esql/images/generated/x-pack-esql/functions/mv_append.svg)


## Parameters

<definitions>
  <definition term="field1">
  </definition>
  <definition term="field2">
  </definition>
</definitions>


## Description

Concatenates values of two multi-value fields.

## Supported types


| field1                                                    | field2                                                    | result          |
|-----------------------------------------------------------|-----------------------------------------------------------|-----------------|
| boolean                                                   | boolean                                                   | boolean         |
| cartesian_point                                           | cartesian_point                                           | cartesian_point |
| cartesian_shape                                           | cartesian_shape                                           | cartesian_shape |
| date                                                      | date                                                      | date            |
| date_nanos                                                | date_nanos                                                | date_nanos      |
| double                                                    | double                                                    | double          |
| flattened <applies-to>Elastic Stack: Planned</applies-to> | flattened <applies-to>Elastic Stack: Planned</applies-to> | flattened       |
| geo_point                                                 | geo_point                                                 | geo_point       |
| geo_shape                                                 | geo_shape                                                 | geo_shape       |
| geohash                                                   | geohash                                                   | geohash         |
| geohex                                                    | geohex                                                    | geohex          |
| geotile                                                   | geotile                                                   | geotile         |
| integer                                                   | integer                                                   | integer         |
| ip                                                        | ip                                                        | ip              |
| keyword                                                   | keyword                                                   | keyword         |
| keyword                                                   | text                                                      | keyword         |
| long                                                      | long                                                      | long            |
| text                                                      | keyword                                                   | keyword         |
| text                                                      | text                                                      | keyword         |
| unsigned_long                                             | unsigned_long                                             | unsigned_long   |
| version                                                   | version                                                   | version         |


## Example

```esql
FROM employees
| WHERE emp_no == 10039 OR emp_no == 10040
| SORT emp_no
| EVAL dates = MV_APPEND(birth_date, hire_date)
| KEEP emp_no, birth_date, hire_date, dates
```


| emp_no:integer | birth_date:date      | hire_date:date       | dates:date                                   |
|----------------|----------------------|----------------------|----------------------------------------------|
| 10039          | 1959-10-01T00:00:00Z | 1988-01-19T00:00:00Z | [1959-10-01T00:00:00Z, 1988-01-19T00:00:00Z] |
| 10040          | null                 | 1993-02-14T00:00:00Z | null                                         |