# On MQTT Topic

## Overview

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

**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/2023.1/toolbox/communication/mqtt/mqttsubscribe.md).

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

## Attributes

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

| 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/sUvzkXSTOQp438EUuTEo)

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/2023.1/toolbox/communication/mqtt/events/onmqttstart.md)
* [**On MQTT Stop**](/incari-studio/2023.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)


---

# 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.incari.com/incari-studio/2023.1/toolbox/communication/mqtt/events/onmqtttopic.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.