jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 09:17:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document value_template in MQTT triggers (#16754)

Browse Source
This commit is contained in:
Erik Montnemery 2021-02-26 10:41:26 +01:00 committed by GitHub
parent 0e86e8e9e5
commit 5e59569350
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
source/_docs/automation/trigger.markdown
View File

@ -97,6 +97,18 @@ automation:
encoding: "utf-8"
```
The `payload` option can be combined with a `value_template` to process the message received on the given MQTT topic before matching it with the payload.
The trigger in the example below will trigger only when the message received on `living_room/switch/ac` is valid JSON, with a key `state` which has the value `"on"`.
```yaml
automation:
trigger:
platform: mqtt
topic: "living_room/switch/ac"
payload: "on"
value_template: "{{ value_json.state }}"
```
It's also possible to use [limited templates](/docs/configuration/templating/#limited-templates) in the `topic` and `payload` options.
<div class='note'>