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)
xFieldstring—data keys (specialized series have their own: angleField, sizeField, openField, …)
yFieldstring—data keys (specialized series have their own: angleField, sizeField, openField, …)
namestringfield namedisplay name of the series (legend, tooltip)
xNamestring—label for the X field in the tooltip
visiblebooleantrueinitial series visibility
showInLegendbooleantrueshow in the legend
tooltip.enabledbooleantruetooltip for the series' nodes
tooltip.renderer(params) => string | TooltipContentData—custom 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/radar:

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
avoidOverlapbooleanfalsedrop labels that collide with each other
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. Placements per series type, the drawing order and overlap handling are covered on the Value labels page.

Markers (marker) ​

Available on line, area and radar series:

Sub-optionTypeDefaultDescription
enabledbooleanline — on, area — off, radar — onshow markers
showOn'always' | 'hover''always''hover' — only the highlighted point (line, area)
shapeMarkerShapecircleshape
sizePixels7 (radar — 6)size
fillColorValueseries colorfill
strokestylesbackgroundstroke
strokeWidthstyles1.5stroke