is an option for charting functions that specifies what legends should be used for chart elements.


  • ChartLegends->{leg1,leg2,} uses legi as a legend label for the i^(th) element in each dataset.
  • The legi can be any strings, graphics, or other static or dynamic expressions.
  • Any legend labels that are specified are collected in a legend that is displayed as part of the chart.
  • The overall form and appearance of legends is specified by settings for LegendAppearance.
  • None indicates no legend label. If there are more elements in a dataset than lbli specified, the subsequent legi are taken to be None.
  • If explicit legending is specified in a dataset using Legended, it is added to legends specified through ChartLegends.
  • Positioning of legends and other effects can be specified using Placed.
  • ChartLegends->Placed[{leg1,leg2,},pos] places the legend containing the legi at the position specified by pos.
  • ChartLegends->{spec1,spec2,} uses the successive speci to specify legend labels for successive dimensions in nested lists of datasets.


Basic Examples  (3)

Generate a legend based on chart style:

Generate a legend for datasets:

Unused legend labels are dropped:

Wolfram Research (2008), ChartLegends, Wolfram Language function,


Wolfram Research (2008), ChartLegends, Wolfram Language function,


Wolfram Language. 2008. "ChartLegends." Wolfram Language & System Documentation Center. Wolfram Research.


Wolfram Language. (2008). ChartLegends. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2021_chartlegends, author="Wolfram Research", title="{ChartLegends}", year="2008", howpublished="\url{}", note=[Accessed: 21-January-2022 ]}


@online{reference.wolfram_2021_chartlegends, organization={Wolfram Research}, title={ChartLegends}, year={2008}, url={}, note=[Accessed: 21-January-2022 ]}