> ## Documentation Index
> Fetch the complete documentation index at: https://bytebeam.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# State Timeline Panel

The State Timeline Panel is a powerful tool for visualizing state changes over time. It is particularly useful in applications where monitoring transitions or durations of different states is critical. Examples include:

* Monitoring machine or device states such as "on," "off," or "error."
* Tracking operational modes like "idle," "active," or "maintenance."
* Visualizing user actions or events over time.

The panel offers a clear and interactive way to explore temporal patterns and provides an option to dynamically change the dashboard's timerange based on a specific state selection.

![](https://usercontent.clueso.io/1f4455e0-789e-4beb-8cd9-4dac96bc47e4/82e0f96e-b5b9-4539-a75f-2850d6826d6c/11c16c61-c4b0-470d-b4f6-e00725ce5d83/images/9a88f69a-6761-4d18-8bcb-a4e3a6f569a6.gif)

## Add State Timeline Panel

**1. Navigate to Dashboards**

Go to the **Dashboards** tab, select the desired dashboard, and click on the **+ Panel** button to create a new panel.

**2. Select State Timeline Panel**

Choose **State Timeline Panel** from the list of available panels.

**3. Configure General Settings**

You will be presented with options to configure:

* **Title**: Add a descriptive title for the panel.
* **Stream**: Select the data stream to visualize.
* **Field**: Choose the field or column that represents the states.

**4. Customize View Settings**

Switch to the **View** tab to adjust the behavior and appearance of the timeline:

* **Enable 'Click State to Change Timerange'**: When enabled, clicking on any point in the State Timeline panel will adjust the dashboard's timerange to the corresponding time period.

**5. Submit the Panel**

After completing the configurations and customizations, click **Submit** to add the State Timeline Panel to the dashboard.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.