mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-02 16:26:50 +00:00
45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
---
|
|
title: "Fan Group"
|
|
description: "Instructions how to setup grouped fans in Home Assistant."
|
|
ha_category:
|
|
- Fan
|
|
ha_release: 2021.11
|
|
ha_iot_class: Local Push
|
|
ha_quality_scale: internal
|
|
ha_domain: group
|
|
---
|
|
|
|
The `group` platform can create a fan that combines several fan entities into one.
|
|
|
|
To enable `Fan Groups` in your installation, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
fan:
|
|
- platform: group
|
|
entities:
|
|
- fan.lanai_west
|
|
- fan.lanai_south
|
|
- fan.lanai_east
|
|
```
|
|
|
|
{% configuration %}
|
|
entities:
|
|
description: List of all fan entities you want to control.
|
|
required: true
|
|
type: [string, list]
|
|
name:
|
|
description: Name to use in the frontend.
|
|
required: false
|
|
type: string
|
|
default: "Fan Group"
|
|
unique_id:
|
|
description: An ID that uniquely identifies this fan group. If two fans have the same unique ID, Home Assistant will raise an error.
|
|
required: false
|
|
type: string
|
|
{% endconfiguration %}
|
|
|
|
## Functionality
|
|
|
|
It works best if you group fans with the same supported features together (like support for `percentage`/`direction`/`oscillation`), but is not limited to it. In case you have bundled fans with different features together, the controls will only affect those fans that support the actions.
|