diff --git a/source/_integrations/water_heater.markdown b/source/_integrations/water_heater.markdown
index 7bd77899ed9..0a014e33f13 100644
--- a/source/_integrations/water_heater.markdown
+++ b/source/_integrations/water_heater.markdown
@@ -20,6 +20,18 @@ water_heater:
   platform: demo
 ```
 
+## The state of a water heater entity
+
+A water heater entity can have the following states:
+
+- **Eco**: Energy efficient mode, provides energy savings and fast heating.
+- **Electric**: Electric only mode. This mode uses the most energy.
+- **Performance**: High performance mode.
+- **High demand**: Meet high demands when the water heater is undersized.
+- **Heat pump**: Heat pump is the slowest to heat, but it uses less energy.
+- **Gas**: Gas only mode. This mode uses the most energy.
+- **Off**: The water heater is off.
+
 ## Actions
 
 ### Water heater control actions