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/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
shapeMarkerShapecircleshape
sizePixels7 (radar — 6)size
fillColorValueseries colorfill
strokestylesbackgroundstroke
strokeWidthstyles1.5stroke