> For the complete documentation index, see [llms.txt](https://docs.incari.com/incari-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incari.com/incari-studio/2024.1/toolbox/communication/mqtt/events/onmqtttopic.md).

# On MQTT Topic

## Overview

![The On MQTT Topic Node.](/files/fpx3j8XwBNwQWFw87Qnn)

**On MQTT Topic** is an **Event Listener Node** that executes when an **MQTT** *Message* (only for the specificed `Topics`) is received. `Topics` are *strings* that act as filters for *Messages* and are hierarchical, meaning there are different levels. Remember, they are case sensitive.

In order to use this **Node**, the user must have already subscribed to the specified `Topics` with the [**MQTT Subscribe Node**](/incari-studio/2024.1/toolbox/communication/mqtt/mqttsubscribe.md).

[**Scope**](https://github.com/cgi-studio-gmbh/incari-doc/blob/2024.1/toolbox/communication/overview.md#scopes): **Project**, **Scene**.

## Attributes

![The On MQTT Topic Node Attributes.](/files/tE4HOnlH9hKLJI2E9RBA)

| Attribute       | Type           | Description                                        |
| --------------- | -------------- | -------------------------------------------------- |
| `Configuration` | **Drop-down**  | The connection, or signal name, that will be used. |
| `Topic`         | **User Input** | The key in the **MQTT** key/value pair.            |

## Example

![On MQTT Topic Example.](/files/xIQkb1JMHVPLJVPrBp5I)

The above image shows what happens when an **MQTT** connection has been made in the **Project Settings**. The connection's name will appear under `Configuration`. One or more `Topic Names` can be added, which appear as **Output Pulses** on the **Node**. It is possible to specify if they are binary or not. Each of these `Topics` have a corresponding `Body` **String**, which is the value in the **MQTT** key/value pair.

## See Also

* [**On MQTT Start**](/incari-studio/2024.1/toolbox/communication/mqtt/events/onmqttstart.md)
* [**On MQTT Stop**](/incari-studio/2024.1/toolbox/communication/mqtt/events/onmqttstop.md)

## External Links

* [*An in-depth explanation of Topics*](http://www.steves-internet-guide.com/understanding-mqtt-topics/#:~:text=%20Understanding%20MQTT%20Topics%20%201%20The%20%24SYS,publish%20to%20an%20individual%20topic.%20That...%20More%20)