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

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

Use `RENAME` to rename a column using the following syntax:

[source,esql]
----
 RENAME <new-name> = <old-name>
----

For example:

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

If a column with the new name already exists, it will be replaced by the new
column.

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

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