Skip to content

Legend

The legend is a side section of the chart that gives a small text description of each series. You can specify the text associated with each series in this legend, and specify where on the chart it should appear.

A Note on String Values

Only URL-safe characters are permitted in label strings. To be safe, you should URL-encode any strings containing characters not in the character set 0-9a-zA-Z.

Syntax

chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>

chdl - The text for each series, to display in the legend.

  • <data_series_label> The text for the legend entries. Each label applies to the corresponding series in the chd array. Use a + mark for a space. If you do not specify this parameter, the chart will not get a legend. There is no way to specify a line break in a label. The legend will typically expand to hold your legend text, and the chart area will shrink to accommodate the legend.

chdlp [Optional] The position of the legend, and order of the legend entries. You can specify <position> and/or <label_order>. If you specify both, separate them with a bar character. You can add an 's' to any value if you want empty legend entries in chdl to be skipped in the legend. Examples: chdlp=bv, chdlp=r, chdlp=bv|r, chdlp=bvs|r

  • <opt_position> [Optional] Specifies the position of the legend on the chart (🚧 partially supported). To specify additional padding between the legend and the chart area or the image border, use the chma parameter. Choose one of the following values:
    • b - Legend at the bottom of the chart, legend entries in a horizontal row.
    • t - Legend at the top of the chart, legend entries in a horizontal row.
    • r - [Default] Legend to the right of the chart, legend entries in a vertical column.
    • l - Legend to the left of the chart, legend entries in a vertical column.
  • <opt_label_order> [Optional] The order in which the labels are shown in the legend. Choose one of the following value:
    • l - [Default for vertical legends] Display labels in the order given to chdl.
    • r - Display labels in the reverse order as given to chdl. This is useful in stacked bar charts to show the legend in the same order as the bars appear.
    • 0,1,2... - Custom label order. This is a list of zero-based label indexes from chdl, separated by commas.

chdls - [Optional] Specifies the color and font size of the legend text.

Examples

How to specify legend text in the same order as your data series:

chart

chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF

chart

chdl=First|Second|Third chco=2196F3,FF5722,9c27b0

How to change legend font color and size:

chart

chdls=9e9e9e,17

Here is how to specify a chart with a right legend position:

a

chdlp=r

Here is how to specify a chart with a left legend position:

a

chdlp=l

Here is how to specify a chart with a bottom legend position:

a

chdlp=b

Here is how to specify a chart with a top legend position:

a

chdlp=t