diff --git a/source/_integrations/mqtt.markdown b/source/_integrations/mqtt.markdown
index e25a0f14dae..0da5a884287 100644
--- a/source/_integrations/mqtt.markdown
+++ b/source/_integrations/mqtt.markdown
@@ -139,6 +139,7 @@ MQTT Devices and entities can be set up through [MQTT -discovery](#mqtt-discover
 - [Switch](/integrations/switch.mqtt/)
 - [Text](/integrations/text.mqtt/)
 - [Valve](/integrations/valve.mqtt/)
+- [Water heater](/integrations/water_heater.mqtt/)
 
 To add an MQTT device via a Subentry, follow these steps:
 
diff --git a/source/_integrations/water_heater.mqtt.markdown b/source/_integrations/water_heater.mqtt.markdown
index 6d66ed97812..4a64a489680 100644
--- a/source/_integrations/water_heater.mqtt.markdown
+++ b/source/_integrations/water_heater.mqtt.markdown
@@ -12,7 +12,7 @@ The `mqtt` water heater platform lets you control your MQTT enabled water heater
 
 ## Configuration
 
-To use an MQTT water heater in your installation, add the following to your {% term "`configuration.yaml`" %} file.
+To use an MQTT water heater in your installation, [add an MQTT device as a subentry](/integrations/mqtt/#configuration), or add the following to your {% term "`configuration.yaml`" %} file.
 {% include integrations/restart_ha_after_config_inclusion.md %}
 
 ```yaml