home-assistant.io/source/_components/group.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category
page	Group	Instructions how to setup groups within Home Assistant.	2015-03-23 19:59	true	false	true	true	home-assistant.png	Organization

Groups allow the user to combine multiple entities into one. A group can be promoted to a view by setting the view option to yes. This will make the group available as a new tab in the frontend.

Check the Set State page from the Developer Tools and browse the Current entities: listing for all available entities.

# Example configuration.yaml entry
group:
  kitchen:
    name: Kitchen
    entities:
      - switch.kitchen_pin_3
  upstairs:
    name: Kids
    icon: mdi:account-multiple
    view: yes
    entities:
      - input_boolean.notify_home
      - camera.demo_camera
      - device_tracker.demo_paulus
      - group.garden

Configuration variables:

• name (Optional): Name of the group.
• icon (Optional): An optional icon to show in the Frontend.
• view (Optional): If yes then the entry will be shown as a view.
• entities array or comma delimited string (Required): List of entites to group.

Example of groups shown as views in the frontend.

If all entities are switches or lights they can be controlled as one with a switch at the top of the card. Grouped states should share the same type of states (ON/OFF or HOME/NOT_HOME).

# Example configuration.yaml entry
group:
  living_room:
    - light.bowl
    - light.ceiling
    - light.tv_back_light
  children: device_tracker.child_1, device_tracker.child_2