---
title: "door or gate unlocked · RUAL Documentation"
description: "Starts the flow when the lock releases, whether or not the door then opens."
canonical: https://docs.rual.nl/block-types/globals/homeassist_trigger_door_unlocked
language: en
---

# door or gate unlocked

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 the lock releases, whether or not the door then opens.

- 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 on the lock_state capability transitioning to "unlocked". This is the ELECTRICAL state of the lock, not the physical position of the door : use door_opened for that. A momentary unlock fires this and then fires door_locked again seconds later when the relay re-locks itself, which is normal.

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

### Version history

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