Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ui.Chart.setSeriesNames
Stay organized with collections
Save and categorize content based on your preferences.
Returns a copy of this chart with updated series names.
| Usage | Returns | Chart.setSeriesNames(seriesNames, seriesIndex) | ui.Chart |
| Argument | Type | Details | this: ui.chart | ui.Chart | The ui.Chart instance. |
seriesNames | Dictionary|Dictionary<String>|List|List<String>|String | New series names. If it's a string, the name of the series at seriesIndex is set to seriesNames. If it's a list, the value at index i in the list is used as a label for series number i. If it's a dictionary or an object, it's treated as a map from existing series names to new series names. In the last two cases, seriesIndex is ignored. |
seriesIndex | Number, optional | The index of the series to rename. Ignored if seriesNames is a list or dictionary. Series are 0-indexed. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-08 UTC.
[null,null,["Last updated 2025-07-08 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eChart.setSeriesNames\u003c/code\u003e function updates the names of series within a chart.\u003c/p\u003e\n"],["\u003cp\u003eYou can update series names using a single string, a list of names, or a dictionary mapping old names to new ones.\u003c/p\u003e\n"],["\u003cp\u003eWhen using a string or list, an optional \u003ccode\u003eseriesIndex\u003c/code\u003e argument specifies the target series (0-based indexing).\u003c/p\u003e\n"],["\u003cp\u003eThe function returns a modified copy of the chart with the updated series names, leaving the original chart unchanged.\u003c/p\u003e\n"]]],["The `Chart.setSeriesNames` function updates series names within a chart. It accepts `seriesNames` as either a string, list, or dictionary. A string renames a specific series by `seriesIndex`. A list sets series names based on their index. A dictionary maps existing series names to new ones. The function returns a new chart (`ui.Chart`) with the updated series names, leaving the original chart untouched. The `seriesIndex` argument is used only when a single string is passed to `seriesNames`.\n"],null,["# ui.Chart.setSeriesNames\n\n\u003cbr /\u003e\n\nReturns a copy of this chart with updated series names.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------------|----------|\n| Chart.setSeriesNames`(seriesNames, `*seriesIndex*`)` | ui.Chart |\n\n| Argument | Type | Details |\n|------------------|----------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `ui.chart` | ui.Chart | The ui.Chart instance. |\n| `seriesNames` | Dictionary\\|Dictionary\\\u003cString\\\u003e\\|List\\|List\\\u003cString\\\u003e\\|String | New series names. If it's a string, the name of the series at seriesIndex is set to seriesNames. If it's a list, the value at index i in the list is used as a label for series number i. If it's a dictionary or an object, it's treated as a map from existing series names to new series names. In the last two cases, seriesIndex is ignored. |\n| `seriesIndex` | Number, optional | The index of the series to rename. Ignored if seriesNames is a list or dictionary. Series are 0-indexed. |"]]