diff --git a/guides/automations.rst b/guides/automations.rst index 2131539aa..aa5df3c59 100644 --- a/guides/automations.rst +++ b/guides/automations.rst @@ -610,6 +610,20 @@ a shorthand way of writing a ``while`` action with an empty ``then`` block.) binary_sensor.is_on: some_binary_sensor - logger.log: "Binary sensor is ready" +If you want to use a timeout, the term "condition" is required: + +.. code-block:: yaml + + # In a trigger: + on_...: + - logger.log: "Waiting for binary sensor" + - wait_until: + condition: + binary_sensor.is_on: some_binary_sensor + timeout: 8s + - logger.log: "Binary sensor might be ready" + + Configuration variables: - **condition** (**Required**): The condition to wait to become true. See :ref:`Conditions `.