# Auto Subscribe
Auto Subscribe is an extended MQTT feature supported by EMQX. With Auto Subscription enabled, users can set multiple EMQX rules. After a client is successfully connected to EMQX, EMQX will complete the subscription process for the client automatically, and the clients no longer need to send
Before EMQX 5.0, this feature is called Proxy Subscription.
# Configure Auto Subscribe via Dashboard
Open EMQX Dashboard. In the left navigation menu, click Management -> Delayed Publish.
On the Delayed Publish page, click the Add button at the upper right corner.
In the pop-up dialog box, type the test topic
a/1in the Topic text box. Leave other settings as default.
Topic: Type the topic that is automatically subscribed to for the client.
QoS: Specify the quality of service of the topic. Options:
No local: Options:
Retain as Published: Specify if the message sent with the specified topic will be retained. Options:
Retained Handling: Options:
Click the Add button on the dialogue box. The auto subscribe topic
a/1is created successfully.
Now the auto subscription function is enabled. New subscribers will subscribe to the topic
a/1 automatically once they are connected to the broker.
# Try Auto Subscription Using MQTTX Client
a/1 is configured as the auto subscribe topic in Configure Auto Subscribe via Dashboard. The following procedure demonstrates how a client subscribes to the topic
a/1 automatically once it is connected to the broker.
- Basic publishing and subscribing operations using MQTTX Client
Start the MQTTX Client. Click the New Connection to create an MQTT connection named
- The localhost
127.0.0.1is used as an example in this demonstration.
For detailed instructions on creating an MQTT connection, see MQTTX Client.
- The localhost
Create another MQTT connection named
a/1as the topic. Send a message on this topic.
Subscriberreceives the message automatically without creating a new subscription.
Publisheralso receives the message as it is also a new connection.
In the publish/subscribe pattern, a client can be both sender and subscriber.
Go to EMQX Dashboard. Click Monitoring -> Subscriptions in the left navigation menu. It shows two subscriptions automatically subscribe to the topic "a/1".
# Try Auto Subscription using MQTTX CLI
- Basic publishing and subscribing operations using MQTTX CLI
Create a new connection with client ID as
mqttx conn -c emqx_c1
Go to EMQX Dashboard. Click Monitoring ->Subscriptions in the left navigation menu. It shows the client
emqx_csubscribes to the topic