diff --git a/source/_integrations/mqtt.markdown b/source/_integrations/mqtt.markdown index 6f15e75f271..b2e448f427a 100644 --- a/source/_integrations/mqtt.markdown +++ b/source/_integrations/mqtt.markdown @@ -160,7 +160,7 @@ Add the MQTT integration, then provide your broker's hostname (or IP address) an 1. Go to **{% my integrations title="Settings > Devices & services" %}**. 2. Select the MQTT integration. -3. Select **Configure**, then **Re-configure MQTT**. +3. Reconfigure the MQTT broker settings via {% my integrations title="**Settings** > **Devices & services**" %}, click {% icon "mdi:dots-vertical" %} and select **Reconfigure**. {% important %} If you experience an error message like `Failed to connect due to exception: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed`, then turn on `Advanced options` and set [Broker certificate validation](/integrations/mqtt/#broker-certificate-validation) to `Auto`. @@ -206,13 +206,21 @@ A configured client certificate will only be active if broker certificate valida ## Configure MQTT options -To change the settings, follow these steps: +To change the options, follow these steps: 1. Go to **{% my integrations title="Settings > Devices & services" %}**. 2. Select the MQTT integration. 3. Select **Configure**, then **Re-configure MQTT**. 4. To open the MQTT options page, select **Next**. +### Change MQTT discovery options + +The MQTT discovery options can be changed by following these steps: + +1. Go to {% my integrations title="**Settings** > **Devices & services**" %}. +2. Find the MQTT integration and select it. +3. To open the MQTT discovery options page, select the **Configure MQTT Options** button. + ### Discovery options MQTT discovery is enabled by default. Discovery can be turned off. The prefix for the discovery topic (default `homeassistant`) can be changed here as well.