[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-08 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eImage.rename()\u003c/code\u003e function allows you to change the names of bands in an Earth Engine image.\u003c/p\u003e\n"],["\u003cp\u003eYou can provide new band names as a list or as individual string arguments.\u003c/p\u003e\n"],["\u003cp\u003eThe number of new band names must match the number of bands in the image.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eImage.rename()\u003c/code\u003e returns a new image with the updated band names.\u003c/p\u003e\n"]]],["The core functionality is to rename the bands of an image using the `Image.rename()` method. This method takes either a list or a series of string arguments as new band names. The number of new names provided must match the existing number of bands. The method returns the image with the updated band names. Examples demonstrate renaming bands of a Sentinel-2 image in both JavaScript and Python, using both a list and individual string arguments.\n"],null,["# ee.Image.rename\n\n\u003cbr /\u003e\n\nRename the bands of an image.\n\n\u003cbr /\u003e\n\nReturns the renamed image.\n\n| Usage | Returns |\n|--------------------------|---------|\n| Image.rename`(var_args)` | Image |\n\n| Argument | Type | Details |\n|---------------|-------------------------------------------|---------------------------------------------------------------------------|\n| this: `image` | Image | The Image instance. |\n| `var_args` | List\\\u003cString\\\u003e\\|Object\\|VarArgs\\\u003cString\\\u003e | The new names for the bands. Must match the number of bands in the Image. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A Sentinel-2 surface reflectance image.\nvar img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')\n .select(['B11', 'B8', 'B3']);\nprint('Original selected S2 image band names', img.bandNames());\n\nprint('Rename bands using a list (JavaScript array or ee.List)',\n img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames());\n\nprint('Rename bands using a series of string arguments',\n img.rename('swir1', 'nir', 'green').bandNames());\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# A Sentinel-2 surface reflectance image.\nimg = ee.Image(\n 'COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG'\n).select(['B11', 'B8', 'B3'])\nprint('Original selected S2 image band names:', img.bandNames().getInfo())\n\nprint('Rename bands using a list (Python list or ee.List):',\n img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames().getInfo())\n\nprint('Rename bands using a series of string arguments:',\n img.rename('swir1', 'nir', 'green').bandNames().getInfo())\n```"]]
