Earth Engine is introducing noncommercial quota tiers to safeguard shared compute resources and ensure reliable performance for everyone. All noncommercial projects will need to select a quota tier by April 27, 2026 or will use the Community Tier by default. Tier quotas will take effect for all projects (regardless of tier selection date) on April 27, 2026 . Learn more.

ee.List

Page Summary

The ee.List(list) function constructs a new list in Earth Engine.
The function takes a list of objects or a computed object as an argument and returns a List.
Examples in both JavaScript and Python demonstrate the usage of ee.List with various data types, including empty lists, null, booleans, numbers, strings, and nested lists.

Constructs a new list.

Usage	Returns
`ee.List(list)`	List

Argument	Type	Details
`list`	List[Object]\|Object	A list or a computed object.

Examples

Code Editor (JavaScript)

 print 
 ( 
 ee 
 . 
 List 
 ([])); 
  
 // [] 
 print 
 ( 
 ee 
 . 
 List 
 ([ 
 null 
 ])); 
  
 // [null] 
 print 
 ( 
 ee 
 . 
 List 
 ([ 
 true 
 ])); 
  
 // [true] 
 print 
 ( 
 ee 
 . 
 List 
 ([ 
 1 
 ])); 
  
 // [1] 
 print 
 ( 
 ee 
 . 
 List 
 ([ 
 ee 
 . 
 Number 
 ( 
 1 
 )])); 
  
 // [1] 
 print 
 ( 
 ee 
 . 
 List 
 ([ 
 'a' 
 ])); 
  
 // ["a"] 
 print 
 ( 
 ee 
 . 
 List 
 ([[]])); 
  
 // [[]] 
 print 
 ( 
 ee 
 . 
 List 
 ([ 
 ee 
 . 
 List 
 ([])])); 
  
 // [[]] 
 print 
 ( 
 ee 
 . 
 List 
 ([[], 
  
 [[]], 
  
 [ 
 1 
 , 
  
 [], 
  
 'a' 
 ]])); 
  
 // [[],[[]],[1,[],"a"]]

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)

 display 
 ( 
 ee 
 . 
 List 
 ([])) 
 # [] 
 display 
 ( 
 ee 
 . 
 List 
 ([ 
 None 
 ])) 
 # [None] 
 display 
 ( 
 ee 
 . 
 List 
 ([ 
 True 
 ])) 
 # [True] 
 display 
 ( 
 ee 
 . 
 List 
 ([ 
 1 
 ])) 
 # [1] 
 display 
 ( 
 ee 
 . 
 List 
 ([ 
 ee 
 . 
 Number 
 ( 
 1 
 )])) 
 # [1] 
 display 
 ( 
 ee 
 . 
 List 
 ([ 
 'a' 
 ])) 
 # ['a'] 
 display 
 ( 
 ee 
 . 
 List 
 ([[]])) 
 # [[]] 
 display 
 ( 
 ee 
 . 
 List 
 ([ 
 ee 
 . 
 List 
 ([])])) 
 # [[]] 
 display 
 ( 
 ee 
 . 
 List 
 ([[], 
 [[]], 
 [ 
 1 
 , 
 [], 
 'a' 
 ]])) 
 # [[], [[]], [1, [], 'a']]

ee.List Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Examples

Code Editor (JavaScript)

Colab (Python)

ee.List