From 0a04184162316c74c5b1e5450fcca2704e1c1da0 Mon Sep 17 00:00:00 2001 From: chammp <57918757+chammp@users.noreply.github.com> Date: Wed, 11 Sep 2024 09:41:39 +0200 Subject: [PATCH] Add docs for conditions for trigger template entities (#33700) * Add docs for template trigger conditions * Add example --- source/_integrations/template.markdown | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/source/_integrations/template.markdown b/source/_integrations/template.markdown index ff433b36b7f..a16c288d35c 100644 --- a/source/_integrations/template.markdown +++ b/source/_integrations/template.markdown @@ -133,6 +133,10 @@ unique_id: description: The unique ID for this config block. This will be prefixed to all unique IDs of all entities in this block. required: false type: string +condition: + description: Define conditions that have to be met after a trigger fires and before any actions are executed or sensor updates are performed. Optional. [See condition documentation](/docs/automation/condition). + required: false + type: list action: description: Define actions to be executed when the trigger fires. Optional. Variables set by the action script are available when evaluating entity templates. This can be used to interact with anything using actions, in particular actions with [response data](/docs/scripts/service-calls#use-templates-to-handle-response-data). [See action documentation](/docs/automation/action). required: false @@ -541,6 +545,27 @@ template: state: "true" ``` +### Using conditions with triggers to control status updates + +This example shows how to store the last valid value of a temperature sensor. It will update as long as the source sensor has a valid (numeric) state. Otherwise, the template sensor's state will remain unchanged. + +{% raw %} + +```yaml +template: + - trigger: + platform: state + entity_id: sensor.outside_temperature + condition: + - condition: template + value_template: "{{ is_number(states('sensor.outside_temperature')) }}" + sensor: + - name: Outside Temperature last known value + state: "{{ states('sensor.outside_temperature') }}" +``` + +{% endraw %} + ### State based sensor exposing sun angle This example shows the sun angle in the frontend.