From ac043879afe8c5460408f94bd19b9a6e5dfe78a0 Mon Sep 17 00:00:00 2001
From: G Johansson <goran.johansson@shiftit.se>
Date: Wed, 27 Nov 2024 15:27:46 +0100
Subject: [PATCH] Add horizontal swing support to ClimateEntity (#34649)

---
 source/_integrations/climate.markdown | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/source/_integrations/climate.markdown b/source/_integrations/climate.markdown
index 576a4b7faec..7457e94aef5 100644
--- a/source/_integrations/climate.markdown
+++ b/source/_integrations/climate.markdown
@@ -33,7 +33,7 @@ An HVAC entity can have the following states, depending on the specific climate
 
 ### Climate control actions
 
-Available actions: `climate.set_aux_heat`, `climate.set_preset_mode`, `climate.set_temperature`, `climate.set_humidity`, `climate.set_fan_mode`, `climate.set_hvac_mode`, `climate.set_swing_mode`, `climate.turn_on`, `climate.turn_off`, `climate.toggle`
+Available actions: `climate.set_aux_heat`, `climate.set_preset_mode`, `climate.set_temperature`, `climate.set_humidity`, `climate.set_fan_mode`, `climate.set_hvac_mode`, `climate.set_swing_mode`, `climate.set_swing_horizontal_mode`, `climate.turn_on`, `climate.turn_off`, `climate.toggle`
 
 {% tip %}
 Not all climate {% term actions %}  may be available for your platform. You can check which climate action are available under **Developer Tools** -> **Actions**.
@@ -230,6 +230,30 @@ automation:
         swing_mode: 1
 ```
 
+### Action `climate.set_swing_horizontal_mode`
+
+Set horizontal swing operation mode for climate device
+
+| Data attribute          | Optional | Description                                                                                                                       |
+| ----------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `entity_id`             | yes      | String or list of strings that define the entity ID(s) of climate device(s) to control. To target all climate devices, use `all`. |
+| `swing_horizontal_mode` | no       | New value of horizontal swing mode.                                                                                               |
+
+#### Automation example
+
+```yaml
+automation:
+  trigger:
+    platform: time
+    at: "07:15:00"
+  action:
+    - action: climate.set_swing_horizontal_mode
+      target:
+        entity_id: climate.kitchen
+      data:
+        swing_horizontal_mode: on
+```
+
 ### Action `climate.turn_on`
 
 Turn climate device on. This is only supported if the climate device supports being turned off.