> For the complete documentation index, see [llms.txt](https://docs.heisenware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.heisenware.com/reference/widgets/display/chart.md).

# Chart

Multi-series chart over object rows — multiple panes, twin value axes, constant lines, pan and zoom

<figure><img src="https://3495989837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE5Ketpww1s7TauSAJrJ8%2Fuploads%2Fgit-blob-1f3d4bfd376c23261f460928200ff191b0b21e45%2Fwidget-chart-line.png?alt=media" alt="Spline chart of two oven temperatures over a shift, with a dashed limit line at 180 °C" width="948"><figcaption></figcaption></figure>

<figure><img src="https://3495989837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE5Ketpww1s7TauSAJrJ8%2Fuploads%2Fgit-blob-afc1209efa57c194c8ee587a4bb3c90d1b740c0f%2Fwidget-chart-bar.png?alt=media" alt="Bar chart comparing the output of three lines per weekday" width="948"><figcaption></figcaption></figure>

A chart draws rows of data as lines, areas, bars, points or bubbles: over time, or across categories such as lines, shifts or products. One chart holds several series, stacked panes and more than one value axis. Constant lines mark targets and limits, and they can come from your logic, so a limit changes with the product. Users hover for exact values, and zoom and pan through long time ranges; aggregation keeps a dense series readable.

**Good for:** sensor trends against limits, output and OEE comparisons, energy and consumption over time.

## Properties

The widget's General tab lists these properties under Receives and Emits. Drop an executor's output, input or trigger onto a row to link it. An example also fills an unlinked widget as demo data in the App Builder.

{% tabs %}
{% tab title="Receives" %}
**`data`** (from an output, `Array<object>`): The data source for charts. Use an array of objects. Each object must be of identical structure/schema, but may contain multiple properties allowing to plot multiple series in one chart.

<details>

<summary>Example</summary>

```json
[
  {
    "timestamp": "2026-08-12T10:00:00Z",
    "pressure": 2.4,
    "temperature": 61.3
  },
  {
    "timestamp": "2026-08-12T10:05:00Z",
    "pressure": 2.7,
    "temperature": 62.1
  },
  {
    "timestamp": "2026-08-12T10:10:00Z",
    "pressure": 2.5,
    "temperature": 61.8
  }
]
```

</details>

**`constantLines`** (from an output, `Array<object>`): Allows to define constant lines for indicating e.g. max, min, ave and the like.

<details>

<summary>Example</summary>

```json
[
  {
    "value": 3.5,
    "label": "max pressure",
    "color": "#dc2828",
    "dashStyle": "dash",
    "labelHorizontalAlignment": "right"
  }
]
```

</details>
{% endtab %}
{% endtabs %}

## Settings

Double-click the widget in the Page editor to open its settings, grouped in these tabs. Settings marked *set per screen* are pinned by nature: every screen keeps its own value.

<details>

<summary>General</summary>

* **Animate**: Eases the display to new data in one second; off draws every update at once, for fast live data.

</details>

<details>

<summary>Series</summary>

* **Argument field**: Field whose values run along the argument axis; nested keys join with a hyphen (sensor-temp).
* **Series data**: Series drawn in the chart, each from one value field.
  * **Pane**: Pane the series is drawn in.
  * **Name**: Name shown in the legend.
  * **Value field**: Field that gives the series its values.
  * **Type**: Drawing style of the series; range types need two range fields, bubble a size field. Choices: Line, Stacked line, Full stacked line, Spline, Stacked spline, Full stacked spline, Step line, Area, Stacked area, Full stacked area, Spline area, Stacked spline area, Full stacked spline area, Step area, Range area, Bar, Stacked bar, Full stacked bar, Range bar, Scatter, Bubble.
  * **Value axis**: Value axis the series is scaled by, named pane-number, the number counting within the pane (Main-1, Tracks-1).
  * **Aggregation**: Combines the points in each aggregation interval into one value; none plots every point. Choices: None, Average, Minimum, Maximum, Sum.
  * **Data points**: Shape of the marker drawn at each data point; none draws no markers. A scatter series always draws its markers: circles when none is chosen. Choices: None, Circle, Cross, Polygon, Square, TriangleUp, TriangleDown.
  * **Custom color**: Color of the series; empty takes the next palette color.
  * **Tag field**: Field whose value replaces the tooltip of a point; empty shows argument and value.
  * **Ignore empty points**: Connects the series across missing values instead of leaving a gap.
  * **Range value 1**: Field for one end of the range in a range area or range bar series. Only when Type is Range area.
  * **Range value 2**: Field for the other end of the range in a range area or range bar series. Only when Type is Range area.
  * **Size field**: Field that sets the bubble size in a bubble series. Only when Type is Bubble.

</details>

<details>

<summary>X-axis</summary>

* **Title**: Title shown along the argument axis; empty shows none.
* **Argument type**: How argument values are read: numeric as numbers, datetime as dates, string as discrete categories. Choices: Numeric, Date & time, String.
* **Width**: Thickness of the axis line in px. Range 1 to 8.
* **Color**: Color of the axis line; auto keeps the theme's.
* **Visible**: Draws the argument axis line.
* **End on tick**: Ends the axis on a major tick instead of at the data edge.
* **Inverted**: Reverses the axis direction.
* **Tick interval unit**: Unit of the spacing between major ticks on a date-time axis; empty lets the chart choose. Choices: Millisecond, Second, Minute, Hour, Day, Week, Month, Quarter, Year.
* **Tick interval**: Number of units between major ticks; takes effect only with a tick interval unit.
* **Aggregation unit**: Unit of the time bucket that series aggregation combines points into; empty sizes buckets by pixel width. Choices: Millisecond, Second, Minute, Hour, Day, Week, Month, Quarter, Year.
* **Aggregation interval**: Number of units per aggregation bucket; takes effect only with an aggregation unit.
* **Label**: Labels along the argument axis: layout, format and font.
  * **Visible**: Shows the argument labels along the axis. *Set per screen.*
  * **Display mode**: Layout of labels that would overlap: one row, staggered across two rows, or rotated; horizontal axes only. Choices: Standard, Stagger, Rotate.
  * **Indent from axis**: Gap between the axis line and its labels in px. Range 4 to 40.
  * **Position**: Draws the labels inside the plot area or outside it. Choices: Inside, Outside.
  * **Format**: Date or number format of the label text; auto shows the value as is. Choices: Auto, Millisecond, Second, Minute, Hour, Day, Day of week, Month, Month and day, Month and year, Quarter, Quarter and year, Year, Short time, Long time, Short date, Long date, Short date short time, Long date long time, Thousands, Millions, Billions, Trillions, Currency, Decimal, Exponential, Fixed point, Large number, Percent.
  * **Size**: Font size of the labels in px. Range 6 to 48. *Set per screen.*
  * **Weight**: Font weight of the labels, 100 (thin) to 900 (black). Range 100 to 900.
  * **Color**: Color of the labels; auto keeps the theme's.
* **Grid & ticks**: Grid lines and tick marks of the argument axis.
  * **Major grid visible**: Draws a grid line at every major tick.
  * **Major grid color**: Color of the major grid lines; auto keeps the theme's.
  * **Minor grid visible**: Draws grid lines between the major ticks.
  * **Minor grid color**: Color of the minor grid lines; auto keeps the theme's.
  * **Major tick visible**: Draws tick marks at the major ticks.
  * **Major tick color**: Color of the major tick marks; auto keeps the theme's.
  * **Minor tick visible**: Draws smaller tick marks between the major ones.
  * **Minor tick color**: Color of the minor tick marks; auto keeps the theme's.

</details>

<details>

<summary>Y-axes</summary>

* **Panes**: Stacked plot areas that share the argument axis; each holds its own value axes.
  * **Name**: Name of the pane; series and axis names refer to it.
  * **Height**: Height of the pane in px (its width on a rotated plot); empty shares the space left. Range 10 to 1000.
  * **Background color**: Background color of the pane behind its series.
  * **Value axes**: Value axes drawn in the pane; a series picks one as pane-1, pane-2 in this order.
    * **Title**: Title shown along the axis; empty shows none.
    * **Position**: Side of the pane the axis is drawn on; top and bottom apply to a rotated plot. Choices: Left, Right, Top, Bottom.
    * **Width**: Thickness of the axis line in px. Range 1 to 8.
    * **Color**: Color of the axis line; auto keeps the theme's.
    * **Start value**: Lowest value shown on the axis; empty fits the data.
    * **End value**: Highest value shown on the axis; empty fits the data.
    * **Visible**: Draws the value axis line.
    * **End on tick**: Ends the axis on a major tick instead of at the data edge (always on while scaling to constant lines).
    * **Inverted**: Reverses the axis direction.
    * **Label**: Labels along the value axis: layout, format and font.
      * **Visible**: Shows the value labels along the axis.
      * **Display mode**: Layout of labels that would overlap: one row, staggered across two rows, or rotated; horizontal axes only. Choices: Standard, Stagger, Rotate.
      * **Indent from axis**: Gap between the axis line and its labels in px. Range 4 to 40.
      * **Position**: Draws the labels inside the plot area or outside it. Choices: Inside, Outside.
      * **Format**: Date or number format of the label text; auto shows the value as is. Choices: Auto, Day, Month, Quarter, Year, Billions, Currency, Decimal, Exponential, FixedPoint, Large number, Long date, Long time, Millions, Millisecond, Month and day, Month and year, Percent, Quarter and year, Short date, Short time, Thousands, Trillions, Day of week, Hour, Long date and time, Minute, Second, Short date and time.
      * **Size**: Font size of the labels in px. Range 6 to 48.
      * **Weight**: Font weight of the labels, 100 (thin) to 900 (black). Range 100 to 900.
      * **Color**: Color of the labels; auto keeps the theme's.
    * **Constant lines**: Marker lines drawn across the plot at fixed values of this axis.
      * **Value**: Axis value the line is drawn at.
      * **Label**: Text shown next to the line; empty shows no label.
      * **Width**: Thickness of the line in px. Range 1 to 16.
      * **Dash style**: Stroke pattern of the line. Choices: Solid, Dash, Long dash, Dot.
      * **Color**: Color of the line and its label text.
      * **Display behind series**: Draws the line under the series instead of on top.
      * **Label position**: Where the label sits relative to the plot area. Choices: Inside the plot, Outside, at the axis.
      * **Label horizontal alignment**: Horizontal placement of the label along the line. Choices: Left, Center (inside only), Right.
      * **Label vertical alignment (inside only)**: Puts the label above or below the line when it sits inside the plot. Choices: Above the line, Below the line.
    * **Grid & ticks**: Grid lines and tick marks of the value axis.
      * **Major grid visible**: Draws a grid line at every major tick.
      * **Major grid color**: Color of the major grid lines; auto keeps the theme's.
      * **Minor grid visible**: Draws grid lines between the major ticks.
      * **Minor grid color**: Color of the minor grid lines; auto keeps the theme's.
      * **Major tick visible**: Draws tick marks at the major ticks.
      * **Major tick color**: Color of the major tick marks; auto keeps the theme's.
      * **Minor tick visible**: Draws smaller tick marks between the major ones.
      * **Minor tick color**: Color of the minor tick marks; auto keeps the theme's.

</details>

<details>

<summary>Legend</summary>

* **Visible**: Shows the legend. *Set per screen.*
* **Title**: Title shown above the legend items; empty shows none.
* **Subtitle**: Smaller text under the legend title; empty shows none.
* **Vertical alignment**: Vertical placement of the legend block in the widget. Choices: Top, Bottom. *Set per screen.*
* **Horizontal alignment**: Horizontal placement of the legend block in the widget. Choices: Right, Center, Left. *Set per screen.*
* **Item text position**: Side of the color marker the item text sits on; empty picks right for a column, bottom for a row. Choices: Top, Bottom, Left, Right.
* **Position**: Draws the legend beside the plot area or overlaid inside it. Choices: Outside, Inside. *Set per screen.*
* **Orientation**: Stacks legend items in a column or lays them in a row; empty picks a row when centered, else a column. Choices: Vertical, Horizontal. *Set per screen.*

</details>

<details>

<summary>Look &#x26; feel</summary>

* **Zoom and pan**: disabled: fixed view; enabled: wheel and pinch zoom, drag pans; selectable: a lock button above the chart turns zoom on and off. Choices: Disabled, Enabled, Selectable. *Set per screen.*
* **Scale to fit constant lines**: Extends every value axis to include its constant lines, with 8 % padding so labels never clip.
* **Synchronize value axes**: Twin axes in one pane share tick positions (grid lines coincide); a range may stretch beyond its data to match. Off: each axis keeps its own range and ticks.
* **Show tooltips**: Shows a value popup when hovering a point.
* **Adjust on zoom**: Rescales the value axes to the points visible after a zoom.
* **Auto hide point markers**: Hides point markers when points get too dense.
* **Enable crosshair**: Follows the cursor with crosshair lines and axis value labels. *Set per screen.*
* **Negatives as zeroes**: Plots negative values as zero.
* **Rotate plot**: Swaps the axes: arguments run vertically, values horizontally. *Set per screen.*
* **Disabled**: Ignores all user interaction (zoom, pan, hover, selection).
* **Bar group padding**: Gap between neighboring bar groups as a fraction of the group width, 0 to 1; ignored when a group width is set.
* **Bar group width**: Fixed width of a bar group in px; empty sizes groups from the padding.
* **Inner margin**: Empty space between the plot and the widget edge in px.
* **Palette**: Colors given to the series in order; empty gives shades of the app accent color.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.heisenware.com/reference/widgets/display/chart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
