Automation Templating

In Home Assistant 0.19 we introduced a new powerful feature: variables in scripts and automations. This makes it possible to adjust your condition and action based on the information of the trigger.

The trigger data made is available during template rendering as the trigger variable.

# Example configuration.yaml entries
automation:
  trigger:
    platform: state
    entity_id: device_tracker.paulus
  action:
    service: notify.notify
    data_template:
      message: >
        Paulus just changed from {{ trigger.from_state.state }}
        to {{ trigger.to_state.state }}

automation 2:
  trigger:
    platform: mqtt
    topic: /notify/+
  action:
    service_template: >
      notify.{{ trigger.topic.split('/')[-1] }}
    data_template:
      message: {{ trigger.payload }}

Available Trigger Data

The following tables show the available trigger data per platform.

event

Template variable	Data
`trigger.platform`	Hardcoded: `event`.
`trigger.event`	Event object that matched.

mqtt

Template variable	Data
`trigger.platform`	Hardcoded: `mqtt`.
`trigger.topic`	Topic that received payload.
`trigger.payload`	Payload.
`trigger.qos`	QOS of payload.

numeric_state

Template variable	Data
`trigger.platform`	Hardcoded: `numeric_state`
`trigger.entity_id`	Entity ID that we observe.
`trigger.below`	The below threshold, if any.
`trigger.above`	The above threshold, if any.
`trigger.from_state`	The previous state object of the entity.
`trigger.to_state`	The new state object that triggered trigger.

state

Template variable	Data
`trigger.platform`	Hardcoded: `state`
`trigger.entity_id`	Entity ID that we observe.
`trigger.from_state`	The previous state object of the entity.
`trigger.to_state`	The new state object that triggered trigger.
`trigger.for`	Timedelta object how long state has been to state, if any.

sun

Template variable	Data
`trigger.platform`	Hardcoded: `sun`
`trigger.event`	The event that just happened: `sunset` or `sunrise`.
`trigger.offset`	Timedelta object with offset to the event, if any.

template

Template variable	Data
`trigger.platform`	Hardcoded: `template`
`trigger.entity_id`	Entity ID that caused change.
`trigger.from_state`	Previous state object of entity that caused change.
`trigger.to_state`	New state object of entity that caused template to change.

time

Template variable	Data
`trigger.platform`	Hardcoded: `time`
`trigger.now`	DateTime object that triggered the time trigger.

zone

Template variable	Data
`trigger.platform`	Hardcoded: `zone`
`trigger.entity_id`	Entity ID that we are observing.
`trigger.from_state`	Previous state object of the entity.
`trigger.to_state`	New state object of the entity.
`trigger.zone`	State object of zone
`trigger.event`	Event that trigger observed: `enter` or `leave`.