generates a legend that associates points of colors coli with labels lbli.


generates a legend with placeholder labels for the colors coli.


represents a legend with inherited colors within visualization functions.

Details and Options

  • PointLegend uses a point with color coli to identify label lbli with elements in a visualization or other legended item.
  • Legended[expr,PointLegend[]] can be used to apply a legend to an arbitrary expression expr.
  • The following options can be given:
  • JoinedFalsewhether to draw a joined line with the points
    LabelStyleAutomaticstyle to use for labels
    LegendFunctionIdentitywrapper for the overall legend
    LegendLabelNoneoverall label for legend
    LegendLayoutAutomaticlegend layout to use
    LegendMarginsAutomaticspace between legend content and boundaries
    LegendMarkersNoneshape of each point
    LegendMarkerSizeAutomaticsize of the shape
  • PointLegend is displayed in StandardForm as a table. In InputForm, it is displayed as an explicit list of colors and labels.
  • In PointLegend, LegendLayout can have the following forms:
  • Automaticautomatically determine layout
    "Row"display legend in a horizontal row
    "Column"display legend in a vertical column
    "ReversedRow"display reversed legend in a horizontal row
    "ReversedColumn"display reversed legend in a vertical column
    fapply f to construct the legend
  • The layout specification f is applied to the table of values {{col1,lbl1},} to generate the legend.
  • LegendFunction is applied to the legend, including any overall label and margins.


open all close all

Basic Examples  (3)

A list of styles and labels:

Click for copyable input

Use placeholder labels:

Click for copyable input

PointLegend is used to automatically create legends for ListPlot:

Click for copyable input

Customize the appearance of the legend:

Click for copyable input

Scope  (14)

Options  (28)

Introduced in 2012