From 32ae4bf8e26b111ac4d523254738a3ba0c14c75e Mon Sep 17 00:00:00 2001
From: WeekendWarrior1 <c.halton.93@gmail.com>
Date: Mon, 27 Sep 2021 05:32:50 +1000
Subject: [PATCH] fan.cycle_speed docs (#1482)

---
 components/fan/index.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/components/fan/index.rst b/components/fan/index.rst
index 656727a20..9193eef00 100644
--- a/components/fan/index.rst
+++ b/components/fan/index.rst
@@ -113,6 +113,20 @@ Configuration options:
 - **direction** (*Optional*, string, :ref:`templatable <config-templatable>`):
   Set the diretion of the fan. Can be either ``forward`` or ``reverse``. Defaults to not changing the direction.
 
+.. _fan-cycle_speed_action:
+
+``fan.cycle_speed`` Action
+--------------------------
+
+Increments through speed levels of the fan with the given ID when executed. If the fan's speed level is set to maximum when executed, turns fan off.
+
+.. code-block:: yaml
+
+    on_...:
+      then:
+        - fan.cycle_speed: fan_1
+
+
 .. _fan-is_on_condition:
 .. _fan-is_off_condition: