> 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/scatter-plot-widget.md).

# Scatter Plot Widget

The Scatter Plot Widget allows you to visualise the relationship between two data fields by plotting one field on the X-axis and another on the Y-axis. This is useful for identifying correlations, trends, and patterns between measurements over time.

## Configuration

### Basics

**Title:** Assign a custom title to the widget.

### Data

**X-Axis Device and Field**

Select the device and field that will be plotted on the X-axis.

**Y-Axis Device and Field**

Select the device and field that will be plotted on the Y-axis.

{% hint style="info" %}
Example: Plot room temperature on the X-axis and room humidity on the Y-axis to visualize how both values relate to each other.
{% endhint %}

### **Timeframe**

Choose the period of historical data to display in the scatter plot (default to the last hour, the last day, week, 2 weeks, last month or personalise your timeframe).

### Appearance

**Show Trail Line:** Connects consecutive data points with a line, making it easier to visualise the progression of values over time.

**Trail Width:** Adjust the thickness of the trail line.

**Point Size:** Define the size of the plotted data points.

**Color Mode:** Choose how points are colored:

* **Single Color** – All points use the same color.
* **Color by Y-Value (Gradient)** – Points are coloured based on their Y value using a color gradient.

When Color by **Y-Value (Gradient)** is enabled, the following options become available:

* **Gradient Start** – Color used for the first value.
* **Gradient End** – Color used for the last value.
* **Min (Optional)** – Define the lower bound of the gradient scale.
* **Max (Optional)** – Define the upper bound of the gradient scale.

Both minimum and maximum values must be numerical.

**Tint Color:** Customize the widget's primary accent color.

**Highlight Color:** Customize the color used for highlighted elements.

**Hide Background:** Removes the widget background for a cleaner appearance.

**Hide Last Update:** Hides the timestamp showing when the widget was last updated.

### References

Reference lines can be added to help identify thresholds or target values.

**X-Axis Reference Value**

Add a numerical reference value on the X-axis.

* Creates a **vertical line** at the specified value.
* Useful for marking limits, thresholds, or target values.
* A custom color can be assigned to the reference line.

**Y-Axis Reference Value**

Add a numerical reference value on the Y-axis.

* Creates a **horizontal line** at the specified value.
* Useful for highlighting limits, thresholds, or target values.
* A custom color can be assigned to the reference line.

### Saving Changes

After configuring the widget, click **Save Changes** to apply the settings and display the scatter plot on your dashboard.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.datacake.de/dashboards/widgets/scatter-plot-widget.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.