> ## 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

<Steps>
  <Step title="Navigate to Dashboards">
    Go to the **Dashboards** tab, select the desired dashboard, and click on the **+ Panel** button to create a new panel.
  </Step>

  <Step title="Select State Timeline Panel">
    Choose **State Timeline Panel** from the list of available panels.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Submit the Panel">
    After completing the configurations and customizations, click **Submit** to add the State Timeline Panel to the dashboard.
  </Step>
</Steps>