From bde967fc197095bab433f6dcceb5f08b733ec474 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Wed, 18 Sep 2024 10:01:21 +0200
Subject: [PATCH] Water heater: add state (#34803)

* Water heater: add state

* Undo formatting changes

* Remove extra line
---
 source/_integrations/water_heater.markdown | 12 ++++++++++++
 1 file changed, 12 insertions(+)

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