displays expr with legend leg.


indicates in plotting and charting functions that a legend entry for expr should be created, with label lbl.


  • The content expr and legend leg in Legended[expr,leg] can be be anything, including graphics, tables, and images.
  • Legended can be used as a symbolic wrapper for data elements and datasets in functions such as ListPlot and BarChart.
  • The legend entry associated with Legended[expr,lbl] includes an identifying prototype, such as a color swatch, for expr, displayed with the label lbl.
  • The label lbl in Legended[expr,lbl] can be any expression, including graphics.
  • Legended[expr,Placed[,pos]] can be used to create legends at different positions.
  • Possible forms for pos are:
  • Above,Below,Before,Afterpositions outside the bounding box for expr
    {{ex,ey},{lx,ly}}scaled position {lx,ly} in the legend at scaled position {ex,ey} in expr
  • The legend leg will frequently be created by functions such as BarLegend and LineLegend.


open allclose all

Basic Examples  (4)

Use Legended to provide legend entries for specific elements:

Use Legended to provide a legend entry for a specific dataset:

Add a legend to a table of values:

Legend a Graph object:

Scope  (6)

Construct a legend for a graphic:

Construct a legend for an image:

Use Legended as a wrapper to specify a legend label for a single dataset:

Specify a legend for a single value:

Use Placed to position the legend:

Place legends outside the legended object:

Place legends inside the legended object:

Neat Examples  (1)

Wolfram Research (2008), Legended, Wolfram Language function, https://reference.wolfram.com/language/ref/Legended.html (updated 2012).


Wolfram Research (2008), Legended, Wolfram Language function, https://reference.wolfram.com/language/ref/Legended.html (updated 2012).


@misc{reference.wolfram_2020_legended, author="Wolfram Research", title="{Legended}", year="2012", howpublished="\url{https://reference.wolfram.com/language/ref/Legended.html}", note=[Accessed: 17-January-2021 ]}


@online{reference.wolfram_2020_legended, organization={Wolfram Research}, title={Legended}, year={2012}, url={https://reference.wolfram.com/language/ref/Legended.html}, note=[Accessed: 17-January-2021 ]}


Wolfram Language. 2008. "Legended." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2012. https://reference.wolfram.com/language/ref/Legended.html.


Wolfram Language. (2008). Legended. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Legended.html