Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
A human-readable name of the task. Defaults to "myExportImageTask".
assetId
String, optional
The destination asset ID.
pyramidingPolicy
Object, optional
The pyramiding policy to apply to each band in the image, keyed by band name. Values must be one of: mean, sample, min, max, or mode. Defaults to "mean". A special key,
".default" may be used to change the default for all bands.
dimensions
Number|String, optional
The dimensions to use for the exported image. Takes either a single positive integer as the maximum dimension or
"WIDTHxHEIGHT" where WIDTH and HEIGHT are each positive integers.
A LinearRing, Polygon, or coordinates representing region to export. These may be specified as the Geometry objects or coordinates serialized as a string.
scale
Number, optional
Resolution in meters per pixel. Defaults to 1000.
crs
String, optional
CRS to use for the exported image.
crsTransform
List<Number>|String, optional
Affine transform to use for the exported image. Requires "crs" to be defined.
maxPixels
Number, optional
Restrict the number of pixels in the export. By default, you will see an error if the export exceeds 1e8 pixels. Setting this value explicitly allows one to raise or lower this limit.
shardSize
Number, optional
Size in pixels of the tiles in which this image will be computed. Defaults to 256.
priority
Number, optional
The priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100.
[[["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\u003eCreates a batch task to export an Earth Engine image as a raster to an Earth Engine asset.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify parameters like the region, scale, CRS, and pyramiding policy for the export.\u003c/p\u003e\n"],["\u003cp\u003eTasks are initiated from the Tasks tab and can be monitored for progress and completion.\u003c/p\u003e\n"],["\u003cp\u003eFor large exports exceeding 1e8 pixels, the \u003ccode\u003emaxPixels\u003c/code\u003e parameter must be increased to prevent errors.\u003c/p\u003e\n"],["\u003cp\u003eExports can be customized to align with specific grids by utilizing the \u003ccode\u003ecrsTransform\u003c/code\u003e parameter alongside \u003ccode\u003ecrs\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Export.image.toAsset\n\n\u003cbr /\u003e\n\nCreates a batch task to export an Image as a raster to an Earth Engine asset. Tasks can be started from the Tasks tab.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|\n| `Export.image.toAsset(image, `*description* `, `*assetId* `, `*pyramidingPolicy* `, `*dimensions* `, `*region* `, `*scale* `, `*crs* `, `*crsTransform* `, `*maxPixels* `, `*shardSize* `, `*priority*`)` | |\n\n| Argument | Type | Details |\n|--------------------|---------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `image` | Image | The image to export. |\n| `description` | String, optional | A human-readable name of the task. Defaults to \"myExportImageTask\". |\n| `assetId` | String, optional | The destination asset ID. |\n| `pyramidingPolicy` | Object, optional | The pyramiding policy to apply to each band in the image, keyed by band name. Values must be one of: mean, sample, min, max, or mode. Defaults to \"mean\". A special key, \".default\" may be used to change the default for all bands. |\n| `dimensions` | Number\\|String, optional | The dimensions to use for the exported image. Takes either a single positive integer as the maximum dimension or \"WIDTHxHEIGHT\" where WIDTH and HEIGHT are each positive integers. |\n| `region` | Geometry.LinearRing\\|Geometry.Polygon\\|String, optional | A LinearRing, Polygon, or coordinates representing region to export. These may be specified as the Geometry objects or coordinates serialized as a string. |\n| `scale` | Number, optional | Resolution in meters per pixel. Defaults to 1000. |\n| `crs` | String, optional | CRS to use for the exported image. |\n| `crsTransform` | List\\\u003cNumber\\\u003e\\|String, optional | Affine transform to use for the exported image. Requires \"crs\" to be defined. |\n| `maxPixels` | Number, optional | Restrict the number of pixels in the export. By default, you will see an error if the export exceeds 1e8 pixels. Setting this value explicitly allows one to raise or lower this limit. |\n| `shardSize` | Number, optional | Size in pixels of the tiles in which this image will be computed. Defaults to 256. |\n| `priority` | Number, optional | The priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A Landsat 8 surface reflectance image.\nvar image = ee.Image('LANDSAT/LC08/C02/T1_L2/LC08_044034_20210508')\n .select(['SR_B.']); // reflectance bands\n\n// A region of interest.\nvar region = ee.Geometry.BBox(-122.24, 37.13, -122.11, 37.20);\n\n// Set the export \"scale\" and \"crs\" parameters.\nExport.image.toAsset({\n image: image,\n description: 'image_export',\n assetId: 'projects/\u003cproject-name\u003e/assets/\u003casset-name\u003e', // \u003c\u003e modify these\n region: region,\n scale: 30,\n crs: 'EPSG:5070'\n});\n\n// Use the \"crsTransform\" export parameter instead of \"scale\" for more control\n// over the output grid. Here, \"crsTransform\" is set to align the output grid\n// with the grid of another dataset. To view an image's CRS transform:\n// print(image.projection())\nExport.image.toAsset({\n image: image,\n description: 'image_export_crstransform',\n assetId: 'projects/\u003cproject-name\u003e/assets/\u003casset-name\u003e', // \u003c\u003e modify these\n region: region,\n crsTransform: [30, 0, -2493045, 0, -30, 3310005],\n crs: 'EPSG:5070'\n});\n\n// If the export has more than 1e8 pixels, set \"maxPixels\" higher.\nExport.image.toAsset({\n image: image,\n description: 'image_export_maxpixels',\n assetId: 'projects/\u003cproject-name\u003e/assets/\u003casset-name\u003e', // \u003c\u003e modify these\n region: region,\n scale: 30,\n crs: 'EPSG:5070',\n maxPixels: 1e13\n});\n\n// The default \"pyramidingPolicy\" is mean. If data are categorical,\n// consider mode.\nExport.image.toAsset({\n image: image.select('SR_B5'),\n description: 'image_export_pyramiding',\n assetId: 'projects/\u003cproject-name\u003e/assets/\u003casset-name\u003e', // \u003c\u003e modify these\n region: region,\n scale: 30,\n crs: 'EPSG:5070',\n pyramidingPolicy: {SR_B5: 'mode'}\n});\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 Landsat 8 surface reflectance image.\nimage = ee.Image(\n 'LANDSAT/LC08/C02/T1_L2/LC08_044034_20210508'\n).select(['SR_B.']) # reflectance bands\n\n# A region of interest.\nregion = ee.Geometry.BBox(-122.24, 37.13, -122.11, 37.20)\n\n# Set the export \"scale\" and \"crs\" parameters.\ntask = ee.batch.Export.image.toAsset(\n image=image,\n description='image_export',\n assetId='projects/\u003cproject-name\u003e/assets/\u003casset-name\u003e', # \u003c\u003e modify these\n region=region,\n scale=30,\n crs='EPSG:5070'\n)\ntask.start()\n\n# Use the \"crsTransform\" export parameter instead of \"scale\" for more control\n# over the output grid. Here, \"crsTransform\" is set to align the output grid\n# with the grid of another dataset. To view an image's CRS transform:\n# print(image.projection().getInfo())\ntask = ee.batch.Export.image.toAsset(\n image=image,\n description='image_export_crstransform',\n assetId='projects/\u003cproject-name\u003e/assets/\u003casset-name\u003e', # \u003c\u003e modify these\n region=region,\n crsTransform=[30, 0, -2493045, 0, -30, 3310005],\n crs='EPSG:5070'\n)\ntask.start()\n\n# If the export has more than 1e8 pixels, set \"maxPixels\" higher.\ntask = ee.batch.Export.image.toAsset(\n image=image,\n description='image_export_maxpixels',\n assetId='projects/\u003cproject-name\u003e/assets/\u003casset-name\u003e', # \u003c\u003e modify these\n region=region,\n scale=30,\n crs='EPSG:5070',\n maxPixels=1e13\n)\ntask.start()\n\n# The default \"pyramidingPolicy\" is mean. If data are categorical,\n# consider mode.\ntask = ee.batch.Export.image.toAsset(\n image=image.select('SR_B5'),\n description='image_export_pyramiding',\n assetId='projects/\u003cproject-name\u003e/assets/\u003casset-name\u003e', # \u003c\u003e modify these\n region=region,\n scale=30,\n crs='EPSG:5070',\n pyramidingPolicy={'SR_B5': 'mode'}\n)\ntask.start()\n```"]]