# 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](https://docs.appfarm.io/library/ui-components/advanced-line-chart).

## 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="../../reference/apps/data/data-sources">data source</a> to display as a chart.</td></tr><tr><td><strong>Filter</strong></td><td>Apply a <a href="../../reference/platform-concepts/filters">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="../../../reference/platform-concepts/date-and-time#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>