Skip to content

Common Series Options

These options are available on all (or nearly all) series types and are not repeated in the tables on individual series pages.

OptionTypeDefaultDescription
idstringauto-generatedstable series identifier (events, sync)
xFieldstringdata keys (specialized series have their own: angleField, sizeField, openField, …)
yFieldstringdata keys (specialized series have their own: angleField, sizeField, openField, …)
namestringfield namedisplay name of the series (legend, tooltip)
xNamestringlabel for the X field in the tooltip
visiblebooleantrueinitial series visibility
showInLegendbooleantrueshow in the legend
tooltip.enabledbooleantruetooltip for the series' nodes
tooltip.renderer(params) => string | TooltipContentDatacustom tooltip content; params depend on the series type

Chart-level blocks (legend, tooltip, highlight, zoom, selection, gradientLegend, animation, …) are covered on the pages of the “Interactivity” section and in the API reference (the Reference section).

Value labels (label)

A uniform structure shared by line/area/scatter/bubble/bar/histogram/range-bar/ waterfall/heatmap/treemap/funnel/pyramid/sunburst/sankey/chord:

Sub-optionTypeDefaultDescription
enabledbooleanfalse (funnel/pyramid/treemap — on)show labels
placementdepends on the seriestop (heatmap/treemap — center)label position
formatter(params) => stringthe valuecontent; params depend on the series
fontSizePixels11 (funnel/pyramid — 12)font size
fontWeightstring | numbernormalfont weight
fontFamilystringtheme fonttypeface
colorColorValueforeground; inside an element — auto-contrasttext color

Labels inside elements (inner-* bars, cells, tiles, sectors, bubble inside) get a halo in the element's color.

Markers (marker)

Available on line, area and radar series:

Sub-optionTypeDefaultDescription
enabledbooleanline — on, area — off, radar — onshow markers
shapeMarkerShapecircleshape
sizePixels7 (radar — 6)size
fillColorValueseries colorfill
strokestylesbackgroundstroke
strokeWidthstyles1.5stroke