> For the complete documentation index, see [llms.txt](https://docs.appfarm.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appfarm.io/library/ui-components/advanced-line-chart.md).

# Advanced line/area chart

The Advanced Line/Area Chart displays a series of data points connected with a straight line, which can also be shown as area or radar chart. It is possible to create more complex charts than with [Basic Line Charts](https://docs.appfarm.io/library/ui-components/basic-line-chart.md). For example, the Category Property is not limited to some data types and more visual properties are available.

## Usage

Advanced Line/Area Charts are used to show changes or trends over a certain time, or to compare multiple datasets.

{% hint style="info" %}
Showroom: [Advanced Line Charts example](https://showroom.appfarm.app/ui-components/advanced-line-chart), with its setup in Appfarm Create ([register](https://showroom.appfarm.app/sign-up) for access).
{% endhint %}

## Properties

| Property                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Data source**         | Select a data source to display as a chart.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Filter**              | Apply a filter to the selected data source.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Conditional filters** | Create conditional filters to apply to the selected data source.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Category property**   | Select a data source to display as X Axis in the chart.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Hide empty**          | <p>Visible when <strong>Category property</strong> is selected.</p><p>Enable to hide categories without content.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Tristate**            | <p>Visible when <strong>Show legend</strong> is enabled and the <strong>Category property</strong> is of data type Boolean.</p><p>By default, false and unset values are treated the same. Enable to treat unset values as a separate category.</p>                                                                                                                                                                                                                                                                                                                                       |
| **Data grouping**       | <p>Visible when <strong>Category property of data type Datetime</strong> is selected.</p><p>Add one or more groupings. Each grouping has a <strong>Group by</strong> dimension to group the data by, a <strong>Custom format</strong> to override the date format (check <a href="https://momentjs.com/docs/#/displaying/format/">momentjs</a> for a complete reference), and an <strong>Enabled</strong> setting. The first enabled grouping is used. If no grouping is enabled, all objects are displayed in the order given by the data source.</p>                                    |
| **Value property**      | Select a data source to aggregate the data on. If no data source is selected, count will be used by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Aggregation**         | <p>Visible when <strong>Value property</strong> is selected.</p><p>Select one of the functions Count, Sum, Average, Median, Minimum or Maximum to aggregate the data on.</p>                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Show uncategorized**  | <p>Visible when <strong>Show legend</strong> is enabled and the <strong>Category property</strong> is of data type Datetime, Enum, String or Reference (or Boolean with <strong>Tristate</strong>).</p><p>Enable to show uncategorized data as a separate category.</p>                                                                                                                                                                                                                                                                                                                   |
| **Area range**          | <p>Visible when <strong>Aggregation</strong> Median or Average is selected.</p><p>Enable to add an area range for the aggregated value.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Default name**        | <p>Read-only when a <strong>Dataset property</strong> is selected or <strong>Static datasets</strong> is enabled.</p><p>Enter a default name for one dataset. If no dataset property is selected, only one dataset will be shown.</p>                                                                                                                                                                                                                                                                                                                                                     |
| **Dataset property**    | <p>Read-only when no <strong>Data source</strong> is selected or <strong>Static datasets</strong> is enabled.</p><p>Select a data source to split the data into datasets based on this property. If no data source is selected, all the data will be treated as a single dataset.</p>                                                                                                                                                                                                                                                                                                     |
| **Color value**         | <p>Visible when a <strong>Dataset property</strong> is set and it is not an enum (for example Boolean, Integer, Duration or a reference).</p><p>Set the dataset color from a data source of type Enum Type.</p>                                                                                                                                                                                                                                                                                                                                                                           |
| **Use enum colors**     | <p>Visible when <strong>Dataset property of type Enumerated Type</strong> is selected.</p><p>Enable to use the colors defined in each Enum Value.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Datasets**            | <p>Visible when the <strong>Dataset property</strong> is a reference.</p><p>Select the data source that holds the referenced objects. Each object becomes a dataset.</p>                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Display value**       | <p>Visible when <strong>Datasets</strong> is set.</p><p>Select the property to show as the name of each dataset. String, Integer, Float and Duration properties can be used.</p>                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Limit datasets**      | <p>Visible when <strong>Dataset property of type Enumerated Type</strong> is selected.</p><p>Enable to limit the dataset property by one or more Enum Values.</p>                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Stack datasets**      | <p>Visible when a <strong>Dataset property</strong> is selected or <strong>Static datasets</strong> is enabled.</p><p>Select None (default), Normal or To 100% to stack the datasets.</p>                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Static datasets**     | <p>Only visible when <strong>Dataset property</strong> is not defined.</p><p>Enable to use static datasets instead of defining a dataset property.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Dataset name**        | <p>Visible when <strong>Static datasets</strong> is enabled.</p><p>Enter a static name for the dataset or bind it to a data source or function.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Filter**              | <p>Visible when <strong>Static datasets</strong> is enabled.</p><p>Apply a filter to the selected data source.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Value override**      | <p>Visible when <strong>Static datasets</strong> is enabled.</p><p>Override the value if the value used for the dataset is stored in another property than the main value property.</p>                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Color**               | <p>Visible when <strong>Static datasets</strong> is enabled.</p><p>Define a color for the dataset.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Disable gradient**    | Enable to lighten up the color value.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Area chart**          | Enable to transform the chart into an area chart.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Opacity**             | <p>Visible when <strong>Area chart</strong> is enabled.</p><p>Define the opacity of the area color.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Show points**         | Enable to visualize points as long as the distance between them are large enough. Otherwise, points will never be displayed.                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Disable bezier**      | Enable to display straight lines instead of rounded lines between each point. May be used to increase performance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Show steps**          | <p>Visible when <strong>Disable bezier</strong> is enabled.</p><p>Enable to draw steps between the points, instead of straight lines.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Step align**          | <p>Visible when <strong>Show steps</strong> is enabled.</p><p>Define whether the steps should be aligned horizontally on the left, center or right.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Title**               | Enter a static title or bind it to a data source, function, date now or date today.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Subtitle**            | Enter a static title or bind it to a data source, function, date now or date today.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Show legend**         | Enable to show a legend.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Legend position**     | <p>Visible when <strong>Show legend</strong> is enabled.</p><p>Position the legend on the top, left, bottom or right side of the chart.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Disable animation**   | Enable to stop animation of the chart.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Zoom type**           | Define if the X Axis, Y Axis or both should be zoomable. By default, None is selected.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Show data labels**    | Enable to show data labels above each data point.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Label decimals**      | <p>Visible when <strong>Show data labels</strong> is enabled.</p><p>Define decimals to override the number of decimals shown in the data labels.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **No hover**            | Enable to turn off hover effects, tooltips and click events on the chart's series. **On series click** then no longer runs.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Tooltip decimals**    | Define decimals to override the number of decimals shown for the y value in the tooltip.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Polar**               | Enable to transform the chart into the polar coordinate system. The chart is then displayed as a polar/radar chart.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Invert axes**         | Enable to invert both X Axis and Y Axis with each other.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Navigator**           | <p>Visible when the <strong>Category property</strong> is of data type Datetime.</p><p>Enable a navigator on the X Axis.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Minimum range**       | <p>Visible if <strong>Navigator</strong> is enabled.</p><p>Define the minimum window, in hours, when zooming in. By default, one week (168 hours) is used.</p>                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Maximum range**       | <p>Visible if <strong>Navigator</strong> is enabled.</p><p>Define the maximum window, in hours, when zooming out. By default, all data is shown.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Axis title**          | Enter a static title or bind it to a data source, function, date now or date today.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Axis type**           | Select a type for the axis: Auto, Linear, Logarithmic, Datetime or Category.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Tick interval**       | Set an interval for ticks on the axis. If the interval is too dense to be displayed, some ticks will be removed automatically. Note that axes with data type Datetime are based on milliseconds.                                                                                                                                                                                                                                                                                                                                                                                          |
| **Tick Mark Placement** | <p>Only applicable for <strong>Category Axis</strong> (X Axis).</p><p>Define the position of the tick marks on the X Axis. If Auto is selected and the interval is 1, the tick mark is placed between categories, else the tick mark is placed in the center of the category. If Between is selected, the tick mark is always placed between categories. If On is selected, the tick mark is always placed in the center of the category.</p>                                                                                                                                             |
| **Min value**           | Define the minimum value on the axis. If no value is set, it will automatically adjust to data.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Extend min to data**  | <p>Visible when <strong>Min value</strong> is set.</p><p>Enable to extend the axis minimum to the lowest value in the data shown.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Max value**           | Define the maximum value on the axis. If no value is set, it will automatically adjust to data.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Extend max to data**  | <p>Visible when <strong>Max value</strong> is set.</p><p>Enable to extend the axis maximum to the highest value in the data shown.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Grid lines**          | Enable to show grid lines on the axis.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Crosshair**           | Enable a crosshair on the axis.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Hide axis**           | Enable to hide the axis.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Reverse axis**        | Enable to reverse the axis in order to display the values from highest to lowest.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Place opposite**      | Enable to place the axis on the opposite side of the chart.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Grid line shape**     | <p>Visible on the Value Axis (Y) when <strong>Polar</strong> is enabled.</p><p>Select Auto, Circle or Polygon to draw the grid lines as circles or straight lines between categories. Default is Auto.</p>                                                                                                                                                                                                                                                                                                                                                                                |
| **Synchronize axis**    | <p>Only applicable for <strong>Category Axis</strong> (X Axis).</p><p>If selected, hover values and zoom will be synchronized across charts. To synchronize this axis with other charts, first a <strong>Topic</strong> in the current <strong>App</strong> (found under <strong>App Settings</strong>) must be created. Any chart connected to the same topic will be synchronized. Synchronization uses chart width to calculate position for the indicators, not axis values. Therefore it must be ensured, that all charts use the same width and showing the same range of data.</p> |
| **Threshold lines**     | Add plot threshold indicators by defining a name, visibility, type (line or band), start value and color.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Event handlers**      | <p>Add an <strong>On series click</strong> action to run when a data series is clicked. See <a href="https://docs.appfarm.io/how-to/user-interface/understand-charts.md#respond-to-clicks-with-on-series-click">Understand charts</a> for the available action params and behavior.</p><p>When <strong>Zoom type</strong> is X Axis or Both, you can also add an <strong>On zoom</strong> action to run when the user zooms the chart.</p>                                                                                                                                                |


---

# 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.appfarm.io/library/ui-components/advanced-line-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.
