MQTT GeneralInstall

Summary

Publish an MQTT message to request the automation to wait for a specific web element's state and optionally wait for a response message before continuing.

Inputs

• Topic (required) — MQTT topic to publish the wait element action message to.
• QoS — Quality of Service level for MQTT message (0, 1, or 2).
• Include Input Items — Whether to include selected input fields from previous workflow items in the payload.
• Include Input Items Fields — Fields to include from previous inputs in payload.inputItems when including input items.
• Wait For Response — Whether to wait for a reply MQTT message from the response topic before returning output.
• Response Topic (required) — MQTT topic to subscribe to and listen for a response message if waiting for response is enabled.
• Response Timeout (ms) — Maximum milliseconds to wait for the response message before timing out.
• Parse Response As JSON — Whether to parse the response payload as JSON when possible.
• Target — High-level selector string to locate the web element (e.g., id=..., css=..., xpath=...).
• XPath — Explicit XPath selector to locate the element, used if no parsing of the 'target' string.
• Wait Type — Condition state to wait for on the element: present, visible, editable, not present, not visible, or not editable.
• Timeout (sec) — Maximum seconds to wait for the element to reach the desired state.

Output shape

a list of items mirroring input items or single item if no input; each item includes the MQTT topic, action details, payload inputs, and optional response data (topic, raw payload, parsed payload) if waiting for response.

If 'Wait For Response' is enabled, the node publishes to the specified topic and subscribes to the response topic, waiting up to 'Response Timeout (ms)' for a response message that is optionally parsed as JSON. Input items can be included selectively into the payload. On failure, errors are either thrown or returned as error objects depending on node settings.

Examples

Example 1: Wait for a button element to become visible

Set 'Target' to a CSS selector identifying the button, 'Wait Type' to 'visible', and 'Timeout' accordingly. Publish to appropriate MQTT topic to make the remote automation wait for this element state.

Example 2: Wait for an element using XPath and get a response

Set 'XPath' to locate the element explicitly, enable 'Wait For Response', specify the 'Response Topic', and adjust the timeout and JSON parsing options to receive confirmation before continuing.

Links

• n8n community nodes installation guide