> For the complete documentation index, see [llms.txt](https://docs.thingsup.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thingsup.io/widgets/data-text-widget.md).
# Data Text Widget
**General Setting**
User can change following things in Data Text widget:
* Name for widget which will be used data reference. For Example, if widget name is 'Data Text', then data of widget is referenced as Data Text.data
* Show title - User can show/hide widget title
* Title Color
* Background Color
**Widget Setting**
In Widget Setting option, user can change following parameters:
* Key - key parameter of JSON Object which will used to get data.
* Data Color
* Unit - Unit for Data
* Decimal units- Number of decimal units
#### Source
User can select a source mode as MQTT or Action.
**Using MQTT**
Here, to show data on Data Text widget user need to send data in given format on given MQTT topic. No need to provide \ while providing the MQTT topic. The JSON object will be as below.
```
// Example
{"dataKey":10.2}
OR
{"dataKey":"hi"}
OR
{"dataKey":"100"}
// 'dataKey' is declared in widget form.
```
**Using Action**
Here, to show data on Data Text Widget, output of the action should contain key-value pair with 'dataKey' key. User can also update the widget either onLoad or periodically by providing refresh interval.
#### Event Handling
Data Text widget does not support any event.
#### Example
If we configure Data Text Widget as below:
1. key - dataKey
2. Unit - %
3. Decimal points - 2
and set source type for widget as MQTT and topic configured is 'data'. And if we publish following JSON Object over 'data' topic then Data Text Widget will look as shown in image.
```
// Data over configured MQTT Topic
{
"dataKey":89.32
}
```
