# Basic line chart

The Basic line chart displays a series of data points connected with a straight line. The chart supports both single and multiple series. For more configuration options, see the [Advanced line/area chart component](/library/ui-components/advanced-line-chart.md).

## Usage

Basic line charts are used to show changes or trends over a certain time, or to compare multiple datasets. 

{% hint style="info" %}
**Examples**

Basic line charts examples are available in our [Showroom](https://showroom.appfarm.app/ui-components/basic-line). You can view the demo, as well as access the setup in Appfarm Create. Don't have access? [Register](https://showroom.appfarm.app/sign-up).
{% endhint %}

## Properties

<table><thead><tr><th width="220">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Data Source</strong></td><td>Select a <a href="/pages/-MiR9-S9HfgyfS92rP2V">data source</a> to display as a chart.</td></tr><tr><td><strong>Filter</strong></td><td>Apply a <a href="/pages/-MiR9GGOxcZeghNQPbzV">filter</a> to the selected data source.</td></tr><tr><td><strong>Conditional Filters</strong></td><td>Create conditional filters to apply to the selected data source.</td></tr><tr><td><strong>Category Property</strong></td><td>Select a data source to display as the X axis. Only the data types boolean, datetime, and enum are supported. </td></tr><tr><td><strong>Hide Empty</strong></td><td><p><em>Visible when <strong>Category Property</strong> is selected.</em></p><p>Enable to hide categories without content. </p></td></tr><tr><td><strong>Group By</strong></td><td><p><em>Visible when <strong>Category Property</strong> with data type datetime is selected.</em></p><p>Select a dimension to group the data by. If no dimension is selected, all objects will be displayed in the order given by the data source.  </p></td></tr><tr><td><strong>Custom Format</strong></td><td><p><em>Visible when <strong>Category Property</strong> with data type datetime and a <strong>Group By</strong> dimension is selected.</em></p><p>Define a <a href="/pages/lpBoRypHh7coiufWAxHq#formatting">custom format</a> to override the format of the data source. </p></td></tr><tr><td><strong>Value Property</strong></td><td>Select a data source to aggregate the data on. If no data source is selected, <code>Count</code> will be used by default. </td></tr><tr><td><strong>Aggregation Function</strong></td><td><p>Visible when <strong>Value Property</strong> is selected.</p><p>Select a function to aggregate the data: <code>Count</code>, <code>Sum</code>, <code>Average</code>, <code>Median</code>, <code>Minimum</code> or <code>Maximum</code>.</p></td></tr><tr><td><strong>Dataset Property</strong></td><td>Select a property to use to split the data into datasets. If no property is selected, all data will be treated as a single dataset. </td></tr><tr><td><strong>Use Enum Colors</strong></td><td><p><em>Visible when <strong>Dataset Property</strong> with type enum is selected.</em></p><p>Enable to use the colors defined in each enum value.</p></td></tr><tr><td><strong>Limit Datasets</strong></td><td><p><em>Visible when <strong>Dataset Property</strong> with type enum is selected.</em>.</p><p>Enable to limit the dataset property by one or more enum values.</p></td></tr><tr><td><strong>Stack Datasets</strong></td><td><p><em>Visible when <strong>Dataset Property</strong> is selected.</em></p><p>Enable to stack the datasets. </p></td></tr><tr><td><strong>Title</strong></td><td>Enter a static title or bind it to a property, function, or default datetime value.</td></tr><tr><td><strong>Title Position</strong></td><td><p><em>Visible when <strong>Title</strong> has been set.</em></p><p>Position the title on the top, left, bottom or right side of the chart. </p></td></tr><tr><td><strong>Show Legend</strong></td><td>Enable to show a legend.</td></tr><tr><td><strong>Legend Position</strong></td><td><p><em>Visible when <strong>Show Legend</strong> is enabled.</em></p><p>Position the legend on the top, left, bottom or right side of the chart.</p></td></tr><tr><td><strong>Show Uncategorized</strong></td><td><p><em>Visible when <strong>Show Legend</strong> is enabled.</em></p><p>Enable to display uncategorized data as a separate category in the legend.</p></td></tr><tr><td><strong>Disable Animation</strong></td><td>Remove animations from the chart. </td></tr><tr><td><strong>Disable Bezier</strong></td><td>Display straight lines instead of rounded lines between each point. May be used to increase performance.</td></tr><tr><td><strong>Hide Points</strong></td><td>Hide the value points.</td></tr><tr><td><strong>Span Gaps</strong></td><td><p><em>Visible when <strong>Aggregation Function</strong> Sum, Average, Median, Minimum or Maximum is enabled.</em></p><p>Enable to draw a line before and after an empty category group.</p></td></tr><tr><td><strong>Y Axis Interval</strong></td><td>Set an interval for ticks on the Y Axis. If the interval is too dense to be displayed, some ticks will be removed automatically.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.appfarm.io/library/ui-components/basic-line-chart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.