.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL-DATASET-RENAME" "1" "Aug 18, 2026" "" "GDAL"
.SH NAME
gdal-dataset-rename \- Rename files of a dataset
.sp
Added in version 3.12.

.sp
\fBgdal dataset rename\fP rename the dataset file(s), including
potential side\-car/associated files.
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal dataset rename [OPTIONS] <SOURCE> <DESTINATION>

Rename files of a dataset.

Positional arguments:
  \-\-source <SOURCE>            Source dataset name [required]
  \-\-destination <DESTINATION>  Destination dataset name [required]

Common Options:
  \-h, \-\-help                   Display help message and exit
  \-\-json\-usage                 Display usage as JSON document and exit
  \-\-config <KEY>=<VALUE>       Configuration option [may be repeated]

Options:
  \-\-overwrite                  Whether overwriting existing output dataset is allowed

Advanced Options:
  \-f, \-\-format <FORMAT>        Dataset format
.EE
.UNINDENT
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-source <FILENAME>
Source file name or directory name. Required.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-destination <FILENAME>
Destination file name or directory name. Required.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-\-format <FORMAT>
Dataset format. Overrides the automatic format detection.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
Allow program to overwrite existing target file or dataset.
Otherwise, by default, \fBgdal\fP errors out if the target file or
dataset already exists.
.UNINDENT
.SH RETURN STATUS CODE
.sp
The program returns status code 0 in case of success, and non\-zero in case of
error (non\-blocking errors emitted as warnings are considered as a successful
execution).
.SH EXAMPLES
.SS Example 1: Rename a dataset
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal dataset rename old_name.tif new_name.tif
.EE
.UNINDENT
.UNINDENT
.SH AUTHOR
Even Rouault <even.rouault@spatialys.com>
.SH COPYRIGHT
1998-2026
.\" Generated by docutils manpage writer.
.