# Line Chart
### What is the Line Chart Widget?
The Line Chart is one of the core widget types available in Birdie Dashboards. It is designed to help you visualize how a metric evolves over time by plotting data points connected by a continuous line. With support for multiple series displayed simultaneously, the Line Chart makes it easy to track trends, identify peaks and drops, and compare performance across different areas, teams, or feedback channels, all within a single view.
#### How to extract the most value from the Line Chart?
The Line Chart is most valuable when your primary question involves change over time. Use it when you want to answer questions such as:
* How has the volume of feedback from my different support channels changed over the past 30 days?
* Which areas of the product are generating the most feedback this quarter compared to last?
* Are certain feedback categories growing or declining week over week?
Because the Line Chart supports breakdowns by dimensions like Areas or Opportunities, you can layer multiple series onto one chart and immediately see which segments are driving changes in your data.
### Setting up a Line Chart
{% stepper %}
{% step %}
#### Select the widget type
When adding a new widget to your dashboard, select **Line** from the widget type options at the top of the configuration panel.
{% endstep %}
{% step %}
#### Add a title and subtitle
In the **Title** field, enter a clear name for your widget. You can also add an optional **Subtitle** to provide additional context for other users viewing the dashboard.
{% endstep %}
{% step %}
#### Configure the data source
Navigate to the **Setup** tab to define what data the chart will display.
* **Metric**: Select the metric you want to track. For example, choose **Overall** to display aggregate feedback counts across all sources.
* **Breakdown**: Select a dimension to split the metric into multiple series. For instance, selecting **Areas** will render one line per area on the chart.
* **Selection**: Use the selection dropdown to choose which specific items within the breakdown to include. By default, all available items are selected.
* **Limit**: Set the maximum number of series displayed on the chart. This is useful when a breakdown returns many results and you only want to surface the most relevant ones.
{% hint style="info" %}
You can toggle **Set vertical axis range** to manually define the minimum and maximum values for the Y-axis, which is useful for standardizing charts across your dashboard.
{% endhint %}
{% endstep %}
{% step %}
#### Configure display settings
Still in the **Setup** tab, scroll down to the **Display settings** section.
* **Always show values on chart**: Enable this toggle to display exact data point values directly on the chart lines, making it easier to read precise figures without hovering.
{% endstep %}
{% step %}
#### Set filters
Navigate to the **Filter** tab to control the time range and granularity of the data shown.
* **Date range**: Select the period you want the chart to cover. The default is **Last 30 days**.
* **Time aggregation**: Choose how data is grouped along the X-axis. The default is **Week**, which plots one data point per week.
* **Advanced filters**: Use the **Add filter** option to refine the data further, for example, by a specific tag, sentiment, or source. You can also enable **Ignore global filter** if you want this widget to display independently of any dashboard-level filters.
{% endstep %}
{% step %}
#### Customize series labels and colors
Navigate to the **Customization** tab to review and edit how each series is labeled and colored on the chart.
* Each breakdown item appears as a numbered series (Serie 1, Serie 2, and so on).
* You can rename any series label by editing the text field next to it.
* Click the color swatch to change the color assigned to that series.
{% hint style="info" %}
Renaming series labels is especially useful when the default breakdown names are long or technical. Clearer labels make the chart easier to read for teammates who may not be familiar with the underlying data structure.
{% endhint %}
{% endstep %}
{% step %}
#### Save the widget
Once you are satisfied with the configuration, click **Save changes** to add the Line Chart to your dashboard.
{% hint style="info" %}
Remember to save the Dashboard itself after setting up the widget, otherwise your changes will not be persisted.
{% endhint %}
{% endstep %}
{% endstepper %}
---
# 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://ask.birdie.ai/voice-of-customer/dashboards-and-reporting/dashboard-widgets/line-chart.md?ask=
```
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.