Binary Sensor Group


The group binary_sensor platform lets you combine multiple binary_sensors into one entity. This integration presents itself as a single binary sensor in the UI. This allows the UI to use the text and icon of the type of sensor you are grouping. The sensor doesn’t know what device class it should be, so this should be set to match the device class of the items in the group.

Group behavior

By default when any member of a group is on then the group will also be on. If you set the all option to true though, this behavior is inverted and all members of the group have to be on for the group to turn on as well.

To enable this platform in your installation, add the following to your configuration.yaml file:

binary_sensor:
    - platform: group
      name: Patio Doors
      device_class: opening
      entities:
        - binary_sensor.door_left_contact
        - binary_sensor.door_right_contact

Configuration Variables

entities string | list Required

A list of entities to be included in the group.

name string (Optional)

The name of the group. Defaults to “Binary Sensor Group”.

unique_id string (Optional)

An ID that uniquely identifies this group. If two binary_sensors have the same unique ID, Home Assistant will raise an error.

all boolean (Optional, default: false)

Set this to true if the group state should only turn on if all grouped entities are on.

device_class string Required

The type of the group (/integrations/binary_sensor).