ee.Image.rename

  • The Image.rename function changes the names of the bands in an image.

  • It returns the image with the renamed bands.

  • The new names for the bands must be provided as a list of strings or a series of string arguments, and the number of new names must match the number of bands in the image.

Rename the bands of an image.

Returns the renamed image.

UsageReturns
Image.rename(var_args)Image
ArgumentTypeDetails
this: imageImageThe Image instance.
var_argsList<String>|Object|VarArgs<String>The new names for the bands. Must match the number of bands in the Image.

Examples

Code Editor (JavaScript)

// A Sentinel-2 surface reflectance image.
var img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')
              .select(['B11', 'B8', 'B3']);
print('Original selected S2 image band names', img.bandNames());

print('Rename bands using a list (JavaScript array or ee.List)',
      img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames());

print('Rename bands using a series of string arguments',
      img.rename('swir1', 'nir', 'green').bandNames());

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

# A Sentinel-2 surface reflectance image.
img = ee.Image(
    'COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG'
).select(['B11', 'B8', 'B3'])
display('Original selected S2 image band names:', img.bandNames())

display('Rename bands using a list (Python list or ee.List):',
      img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames())

display('Rename bands using a series of string arguments:',
      img.rename('swir1', 'nir', 'green').bandNames())