> 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/html-tile-widget.md).

# HTML Tile Widget

**General Setting**

User can change following things in HTML Tile widget:

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

![Configure HTML Tile Widget](/files/afyDnrFlYMdLyf9JZDKU)

**Widget Setting**

In Widget Setting option, user can change following parameters:

* Key - key parameter of JSON Object which will define data of HTML Tile Widget. User can provide multiple comma seprated keys.
* CSS - User can provide CSS styling&#x20;
* HTML -  User can write HTMl code here using keys also.

![Configure HTML Tile Widget](/files/8AA7WLpXQX6vdVn4xC56)

![Configure HTML Tile Widget](/files/mwaQ3pZL6I06WQWQA6po)

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

User can select a source mode as MQTT or Action.

**Using MQTT**

Here, to update data on HTML Tile Widget user can publish JSON object on given **testData** MQTT topic. No need to provide \<account\_id> while providing the MQTT topic. The JSON object will be as below.

```
// Example 

{
    "key1":"Hello World !!!",
    "key2":"My name is John"
}

// Here, 'key1' and 'key2' are the keys defined for HTML Tile widget.
```

![Configure HTML Tile Widget](/files/jpI6WOsuXBT6ElhGBuUM)

**Using Action**

Here, to update the data on HTML Tile widget, output of the action should contain JSON object as given in above example. User can also update the widget either onLoad or periodically by providing refresh interval.

![Configure HTML Tile Widget](/files/3KuDPdrgSkycSO7z158U)

#### Event Handling

HTML Tile widget does not support any event.

#### Example

If we write CSS code for widget as:

```
.tile{ background-color: red; color: white;}
.tile2{ background-color: blue; color: white;}
```

and write HTML Code for widget as:

```
<div class="tile">{key1}</div>
<div class="tile2">{key2}</div>
```

and set source type for widget as MQTT and topic configured is 'data'. And if we publish following JSON Object over 'data' topic then HTML Widget will look as shown in image.

```
// Data over configured MQTT Topic

{ 
    "key1":"Hello World !!!", 
    "key2":"My name is John"
}
```

![HTML Tile Widget Example](/files/EG3f8ZX1sQcu2D2jOuig)


---

# 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.thingsup.io/widgets/html-tile-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.
