> For the complete documentation index, see [llms.txt](https://docs.datacake.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datacake.de/dashboards/widgets/measurement-list-widget.md).

# Measurement List Widget

The Measurement List Widget allows you to display historical data with timestamps directly on your dashboard. It is ideal for tracking sensor readings, monitoring system performance, and analysing trends over time.

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2Fsm20t0qeqhhQtZYPac4I%2FCleanShot%202025-01-13%20at%2009.42.53%402x.png?alt=media&amp;token=07fa3061-c41c-4c0f-b1ee-c6f89986511a" alt=""><figcaption></figcaption></figure>

It is available on both device and global dashboards.

## **Configuration**

Once you’ve added the widget, a configuration menu will appear with the following tabs:

**1. Basics**

* Add your widget's title. This will help you identify the data source or the type of data displayed in it.
* You can add translations of that title.

2. Data

* Select the device from which you want to pull data.
* On device dashboards, simply select the data field you want to display. On global dashboards you can select the device and the field you want to display.
  * You may also control here how many rows of data are displayed per page on your widget.
* Toggle whether or not you would like to colour values or booleans based on ranges you provide
  * You can highlight different value ranges or different booleans (True or False) to correspond with preferred results.
    * For the Custom Booleans, you can customise exactly what your True and False represent
  * For example, you can set a range of undesirable temperature ranges as Red, and desirable target temperatures as Green:

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2Fowb5SnsuOtVhAmYtbgu7%2FScreenshot%202025-09-16%20at%2015.55.08.png?alt=media&amp;token=1ade99a6-a7ea-41f4-bd59-a99ff7d10823" alt=""><figcaption></figcaption></figure>

* The widget will automatically populate with historical values and their corresponding timestamps.

## **Practical Applications**

* **Trend Analysis:** Easily identify patterns in your data over time.
* **Anomaly Detection:** Quickly spot any irregularities in the data.
* **Historical Review:** Keep an eye on past readings for deeper insights.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.datacake.de/dashboards/widgets/measurement-list-widget.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.