elasticsearch/docs/reference/esql/processing-commands/rename.asciidoc

[discrete]
[[esql-rename]]
=== `RENAME`

The `RENAME` processing command renames one or more columns.

**Syntax**

[source,esql]
----
RENAME old_name1 AS new_name1[, ..., old_nameN AS new_nameN]
----

*Parameters*

`old_nameX`::
The name of a column you want to rename.

`new_nameX`::
The new name of the column.

*Description*

The `RENAME` processing command renames one or more columns. If a column with
the new name already exists, it will be replaced by the new column.

*Examples*

[source,esql]
----
include::{esql-specs}/docs.csv-spec[tag=rename]
----


Multiple columns can be renamed with a single `RENAME` command:

[source,esql]
----
include::{esql-specs}/docs.csv-spec[tag=renameMultipleColumns]
----