---
title: "doorbell rang · RUAL Documentation"
description: "Starts the flow when someone rings a doorbell or door station."
canonical: https://docs.rual.nl/block-types/globals/homeassist_trigger_doorbell
language: en
---

# doorbell rang

This block is part of the [`globals`](https://docs.rual.nl/block-types/globals) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

Starts the flow when someone rings a doorbell or door station.

- 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.

- 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. Fires on a doorbell ring event from a UniFi door station, a Protect doorbell camera, or any device exposing the doorbell capability. A ring is momentary : every press fires, there is no 'still ringing' state to dedupe against.

| `zigbee` |
| --- |
| `zwave` |
| `matter` |
| `thread` |
| `smart home` |
| `home assistant` |
| `trigger` |

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).