From f79ca2b116828a71355960cad36ca4bee85c1abd Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Tue, 17 Sep 2024 16:23:19 +0200
Subject: [PATCH] Climate: add state (#34779)

* Climate: add state

* Remove unrelated list items

* revert formatting changes
---
 source/_integrations/climate.markdown | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/source/_integrations/climate.markdown b/source/_integrations/climate.markdown
index a94204770de..dedf0736785 100644
--- a/source/_integrations/climate.markdown
+++ b/source/_integrations/climate.markdown
@@ -15,6 +15,18 @@ The **Climate** {% term integration %} allows you to control and monitor HVAC (h
 
 {% include integrations/building_block_integration.md %}
 
+## The state of a HVAC entity
+
+A HVAC entity can have the following states, depending on the specific climate device and its capabilities.
+
+- **Off**: The device is turned off.
+- **Heat**: The device is set to heat to a target temperature.
+- **Cool**: The device is set to cool to a target temperature.
+- **Heat/Cool**: The device is set to heat/cool to a target temperature range.
+- **Auto**: The device is set to a schedule, learned behavior, AI.
+- **Dry**: The device is set to dry/humidity mode.
+- **Fan only**: The device only has the fan on. No heating or cooling is taking place.
+
 ## Actions
 
 ### Climate control actions