---
title: How to use the MQTT WebClient
description: This article describes how to use the MQTT WebClient
totalTime: PT5M
tags: iot iot-hub mqtt webclient
dates:
  validation: 
  posted: 2021-09-01
  validation_frequency: 12
---
import Requirements from '@macros/iam/requirements.mdx'

import image from './assets/scaleway-iothub-webclient.webp'


An MQTT WebClient is embedded in the [Scaleway console](https://console.scaleway.com/iot-hub/hubs).

You can use it to connect to your hub as a device and publish and subscribe to topics on the hub without having to set up a command line tool on your computer.

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- [Created an IoT Hub](/iot-hub/how-to/create-hub/)
- [Added a device](/iot-hub/how-to/add-device/) that allows insecure connections to your hub

1. Open the WebClient by either:
    - Clicking **MQTT Webclient** in the top right corner of the Device overview tab.
    - Clicking the open-in-a-new-window button next to Default WebSocket Network on the hub's networks list.

    <Message type="note">
      If you opened the WebClient from the Device overview tab, you will be automatically connected to the hub with this Device. If you opened the WebClient from the Networks tab, you must set the `Username` field to a valid Device ID and click the connect button.
    </Message>

  Once you connect to the WebClient, you can perform different operations. In this how to, we indicate how to subscribe to a topic, publish a message, and verify the message was received.
2. Click **Add new subscription** in the **Subscriptions** panel.
3. Choose `my/topic` as the topic and click **Subscribe**.
4. Write `my/topic` under the **Topic** field, and `Hello World` in the **Message** field in the **Publish** panel. Then, click **Publish**.

    The message should appear in the **Messages**.

<Lightbox image={image} size="large" alt="" />

<Message type="note">
  To learn more about MQTT, refer to [An Introduction to the MQTT protocol](https://www.scaleway.com/en/blog/introduction-to-mqtt-protocol/) blog post.
</Message>