Chart

The chart is a powerful data visualization widget capable of creating a large variety of visuals.

Series

A chart contains one or more series. A series is a collection of related data points, which can be visualized in different ways.

The chart widget offers 21 types of series, which can be selected in the Data Settings panel.

All types of single-series chart

Chart Settings

The chart settings panel includes settings that apply to the entire widget, in particular visual and user interaction ones.

Some of the most important are:

  • Show value tooltips: Active by default, enables the tooltips that appear when hovering over a data point

  • Adjust on zoom:

  • Auto-hide point markers: When point markers are active, selecting this option hides them when the chart is too small

  • Enable crosshairs:

Value Axis

The value axis is the Y axis on a non-rotated chart, and represents numerical data.

You can add an unlimited number of value axes to a chart widget. Any series or pane can have multple (but at least one) value axes.

Panes

To add multiple, separate charts to a single instance of the widget, you can add panes.

Value Axes

Here you an add multiple value axes to a pane and edit them.

Constant lines

For each value axis you can add constant lines to mark a fixed value. The appearence of these lines is also customizable.

Argument Axis

The argument axis is the X axis on a non-rotated chart. Argument can be numbers, categories or datetime types.

A chart can only have one argument.

Legend

By default, a new chart will have a visible legend.

In the legend settings you can hide or reposition it, add a title and subtitle or change the position of the text with respect to the symbols.

Data Settings

All the series are added and managed in the data settings.

Here you can assign a data field to the argument axis, and create and edit any number of series, including:

  • Assign a value field

  • Select a series type

  • Name the series

  • Assign a series to a pane and value axis if you have more than one

  • Toggle data point markers and change their shape

  • Assign a tag field which will appear in the tooltip (if active)

  • Choose an aggregation

Interacting with the chart

On desktop, you can zoom the chart by scrolling with a mouse or trackpad.

  • If the cursor is on one of the axes, it zooms in only one dimension while leaving the other unchanged.

  • If the cursor is within the pane, the chart zooms in without warping and the zoom is centered on the cursor position.

On touch-enabled devices, you can zoom using the spread and pinch gestures and pan the chart using the drag gesture.

Last updated