Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
Stay organized with collections
Save and categorize content based on your preferences.
Select properties from each Feature in a collection. It is also possible to call this function with only string arguments; they will be all be interpreted as propertySelectors (varargs).
Returns the feature collection with selected properties.
[[["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\u003e\u003ccode\u003eFeatureCollection.select()\u003c/code\u003e allows you to select specific properties (attributes) from each feature within a FeatureCollection.\u003c/p\u003e\n"],["\u003cp\u003eYou can select properties by their names, rename them, and optionally retain or remove the feature's geometry.\u003c/p\u003e\n"],["\u003cp\u003eIt accepts arguments like \u003ccode\u003epropertySelectors\u003c/code\u003e for specifying properties to select, \u003ccode\u003enewProperties\u003c/code\u003e for renaming them, and \u003ccode\u003eretainGeometry\u003c/code\u003e to control geometry inclusion.\u003c/p\u003e\n"],["\u003cp\u003eThe function returns a new FeatureCollection containing only the selected properties (and potentially modified geometry) for each feature.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\nSelect properties from each Feature in a collection. It is also possible to call this function with only string arguments; they will be all be interpreted as propertySelectors (varargs).\n\n\u003cbr /\u003e\n\nReturns the feature collection with selected properties.\n\n| Usage | Returns |\n|---------------------------------------------------------------------------------------|-------------------|\n| FeatureCollection.select`(propertySelectors, `*newProperties* `, `*retainGeometry*`)` | FeatureCollection |\n\n| Argument | Type | Details |\n|---------------------------|--------------------------|----------------------------------------------------------------------------------------------|\n| this: `featurecollection` | FeatureCollection | The FeatureCollection instance. |\n| `propertySelectors` | List\\\u003cString\\\u003e | A list of names or regexes specifying the attributes to select. |\n| `newProperties` | List\\\u003cString\\\u003e, optional | A list of new names for the output properties. Must match the number of properties selected. |\n| `retainGeometry` | Boolean, optional | When false, the result will have a NULL geometry. Defaults to true. |\n\nExamples\n\nCode Editor (JavaScript) \n\n```javascript\n// FeatureCollection of power plants in Belgium.\nvar fc = ee.FeatureCollection('WRI/GPPD/power_plants')\n .filter('country_lg == \"Belgium\"');\n\n// Select a single property.\nvar singleProp = fc.select('fuel1');\nprint('Single property selected',\n singleProp.first());\n\n// Select multiple properties.\nvar multiProp = fc.select(['fuel1', 'capacitymw']);\nprint('Multiple properties selected',\n multiProp.first());\n\n// Select multiple properties and rename them.\nvar multiPropRename = fc.select({\n propertySelectors: ['fuel1', 'capacitymw'],\n newProperties: ['Fuel_1', 'Capacity_MW']\n});\nprint('Multiple properties selected, renamed',\n multiPropRename.first());\n\n// Select multiple properties, remove geometry.\nvar multiPropNoGeom = fc.select({\n propertySelectors: ['fuel1', 'capacitymw'],\n retainGeometry: false\n});\nprint('Multiple properties selected, geometry removed',\n multiPropNoGeom.first());\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\nColab (Python) \n\n```python\n# FeatureCollection of power plants in Belgium.\nfc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(\n 'country_lg == \"Belgium\"')\n\n# Select a single property.\nsingle_prop = fc.select('fuel1')\nprint('Single property selected:', single_prop.first().getInfo())\n\n# Select multiple properties.\nmulti_prop = fc.select(['fuel1', 'capacitymw'])\nprint('Multiple properties selected:', multi_prop.first().getInfo())\n\n# Select multiple properties and rename them.\nmulti_prop_rename = fc.select(**{\n 'propertySelectors': ['fuel1', 'capacitymw'],\n 'newProperties': ['Fuel_1', 'Capacity_MW']\n })\nprint('Multiple properties selected, renamed:',\n multi_prop_rename.first().getInfo())\n\n# Select multiple properties, remove geometry.\nmulti_prop_no_geom = fc.select(**{\n 'propertySelectors': ['fuel1', 'capacitymw'],\n 'retainGeometry': False\n })\nprint('Multiple properties selected, geometry removed:',\n multi_prop_no_geom.first().getInfo())\n```"]]