presence detected

This block is part of the globals group and was last modified in core v15.0.0.

presence detected v15.0.0

Starts the flow when someone is detected in a room.

In pins 2
  • device v15.0.0
    value

    Only fire for this device. Leave empty to fire for every matching device.

  • room v15.0.0
    value

    Only fire for devices in this room. Leave empty for every room.

Out pins 9 + flow
  • flow v15.0.0
    flow
  • device v15.0.0
    object

    The full device: id, name, room, type, capabilities, current state.

  • device id v15.0.0
    value

    Stable platform id, e.g. zigbee:0x00158d0007e1a2b3.

  • name v15.0.0
    value

    The device's friendly name.

  • room v15.0.0
    value

    The room the device is assigned to, empty if none.

  • type v15.0.0
    value

    sensor, light, switch, climate, cover, lock or button.

  • capability v15.0.0
    value

    Which capability changed, e.g. occupancy, contact, power.

  • value v15.0.0
    value

    The new value.

  • previous v15.0.0
    value

    The value before this change, empty on the first report.

  • at v15.0.0
    number

    Unix seconds the device reported.

Start-of-flow trigger for occupancy specifically. Equivalent to sensor activated with sensor_type=occupancy, and exists because it is the single most common automation. Fires on the false->true transition.

zigbee
zwave
matter
thread
smart home
home assistant
trigger

The most common automation there is. presence detected fires on the false to true transition of occupancy in the hallway, so somebody standing still does not re-run it. Its device id feeds get device state, which reads the illuminance the same sensor reports; < compares that against 30 lux and branch only lets light on run when the room is actually dark.

Studio canvas example for the presence detected block: motion, but only after dark.

Used in these guides

These documentation pages use or explain this block:

Version history

Introduced in v15.0.0.


Back to globals Return to the main group to view all sub-groups Back to home Return to the group to view all blocks within this group