Doorbell

The Doorbell integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides an automation trigger for event entities with the doorbell device class.

Supported entities

The Doorbell integration supports the following entity types:

  • Event entities with the doorbell device class.

Configuration

The Doorbell integration does not require any configuration.

Supported functionality

The Doorbell integration provides the following automation trigger for doorbell event entities.

List of triggers

The Doorbell integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following triggers. Each link below opens a dedicated page with examples, fields, and a step-by-step UI walkthrough.

  • Doorbell rang (doorbell.rang) Triggers when one or more doorbells ring.

For an overview of every trigger across all integrations, see the triggers reference.

Doorbell automation examples

You can use this trigger to get a notification when someone is at the door, or to turn on a light when someone rings.

Tip

You don’t need to edit YAML to use these examples. Copy a YAML snippet from this page, open the automation editor in Home Assistant, and press Ctrl+V (or Cmd+V on Mac). Home Assistant automatically converts the pasted YAML into the visual editor format, whether it’s a full automation, a single trigger, a condition, or an action.

Automation: send a notification when someone rings the doorbell

Get a notification on your phone when someone rings the front door, so you know someone is there even when you can’t hear the chime.

  • Trigger: Doorbell rang
    • Target: Front door doorbell
  • Action: Send a notification message
    • Target: My Device (notify.my_device)
YAML example for a doorbell notification
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more]
alias: "Notify when someone rings the doorbell"
triggers:
  - trigger: doorbell.rang
    target:
      entity_id: event.front_door_doorbell
actions:
  - action: notify.send_message
    target:
      entity_id: notify.my_device
    data:
      message: "Someone rang the front door doorbell."

Automation: turn on the porch light when someone rings after sunset

When someone rings the doorbell after sunset, turn on the porch light so you can see who is at the door.

  • Trigger: Doorbell rang
    • Target: Front door doorbell
  • Condition: State
    • Entity: Sun
    • State: Below horizon
  • Action: Turn on light
    • Target: Porch light
YAML example for turning on the porch light
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more]
alias: "Turn on the porch light when someone rings after sunset"
triggers:
  - trigger: doorbell.rang
    target:
      entity_id: event.front_door_doorbell
conditions:
  - condition: state
    entity_id: sun.sun
    state: "below_horizon"
actions:
  - action: light.turn_on
    target:
      entity_id: light.porch