# Scatter Chart Widget

**General Setting**

User can change following things in Scatter Chart widget:

* Name for widget which will be used data reference. For Example, if widget name is 'Scatter Chart', then data of widget is referenced as Scatter Chart.data
* Show title - User can show/hide widget title
* Title Color
* Background Color

![Configure Scatter Chart Widget](/files/8m4OIIC9eHu5J2nESjVc)

**Widget Setting**

In Widget Setting option, user can change following parameters:

* Dot Size - Integer value for dot size
* X Key - key parameter of JSON Object which will define X-Axis value.
* Show Legend - Enable to show legends
* Y Keys - key parameter of JSON Object which will define Y-Axis values.
* X Legend - String value as a Legend for the X Axis 
* Y Legend - String value as a Legend for the Y Axis 

![Configure Scatter Chart Widget](/files/74Nl8IP7Yqp4hEae5KOc)

![Configure Scatter Chart Widget](/files/GIbc3Lku5O5vRcNCAOM3)

#### Source <a href="#source" id="source"></a>

User can select a source mode as MQTT or Action.

**Using MQTT**

Here, to update data on Scatter Chart user can publish JSON array on given **data** MQTT topic. No need to provide \<account\_id> while providing the MQTT topic. The JSON array will be as below.

```
// Example

[
  {
    "x": 42,
    "y": 116,
    "z": 60
  },
  {
    "x": 22,
    "y": 86,
    "z": 30
  }
]

// here, 'x' is set as X Key and 'y' and 'z' are set as Y keys with 'groupA' and
 'groupB' as labels respectively.
```

![Configure Scatter Chart Widget](/files/eocaX1EidhGF9LbCT0H5)

**Using Action**

Here, to update the Scatter Chart widget, output of the action should contain JSON array as given in above example. User can also update the widget either onLoad or periodically by providing refresh interval.

![Configure Scatter Chart Widget](/files/2p8GE9hpImVGMbwEgZpk)

#### Event Handling

Scatter Chart widget does not support any event.

#### Example

Here, data in below format published on configured topic, will appear as shown in image.

```
// Example

[
  {
    "x": 42,
    "y": 116,
    "z": 60
  },
  {
    "x": 22,
    "y": 86,
    "z": 30
  }
]

// here, 'x' is set as X Key and 'y' and 'z' are set as Y keys with 'groupA' and 'groupB' as labels respectively.

```

![MQTT Data for Scatter Chart](/files/sk3Uz38QGW0QEQHuZuWB)

![Scatter Chart Example](/files/QOLdLFg4q3bLyIHGwnqy)


---

# 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://docs.thingsup.io/widgets/scatter-chart-widget.md?ask=<question>
```

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.