jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-16 22:06:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Areas and floors: add links and glossary refs (#38903)

Browse Source
This commit is contained in:
c0ffeeca7 2025-05-06 12:06:37 +02:00 committed by GitHub
parent 6dc6faaf26
commit 6eda62ae13
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 18 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
source/_data/glossary.yml
View File

@ -42,7 +42,7 @@
link: /getting-started/concepts-terminology/#add-ons link: /getting-started/concepts-terminology/#add-ons
- term: Area - term: Area
definition: >- definition: >-
An area in Home Assistant is a logical grouping of devices and entities that An area in Home Assistant is a [logical grouping](/docs/organizing/) of devices and entities that
are meant to match areas (or rooms) in the physical world: your home. For are meant to match areas (or rooms) in the physical world: your home. For
example, the `living room` area groups devices and entities in your living example, the `living room` area groups devices and entities in your living
room. Areas allow you to target actions at an entire group of devices. room. Areas allow you to target actions at an entire group of devices.
@ -51,7 +51,7 @@
floors. Areas can also be used for automatically generated cards, such as floors. Areas can also be used for automatically generated cards, such as
the [Area card](/dashboards/area/). the [Area card](/dashboards/area/).
excerpt: >- excerpt: >-
An area in Home Assistant is a logical grouping of devices and entities that An area in Home Assistant is a [logical grouping](/docs/organizing/) of devices and entities that
are meant to match areas (or rooms) in the physical world: your home. For are meant to match areas (or rooms) in the physical world: your home. For
example, the `living room` area groups devices and entities in your living example, the `living room` area groups devices and entities in your living
room. room.
@ -110,7 +110,7 @@
- buttons - buttons
- term: Category - term: Category
definition: >- definition: >-
A category is an organization tool that allows grouping items in a table. A category is an organization tool that allows [grouping](/docs/organizing/) items in a table.
Like labels, categories allow grouping irrespective of the items' physical Like labels, categories allow grouping irrespective of the items' physical
location. For example, on the automations page, you can create the location. For example, on the automations page, you can create the
categories “Notifications” or “NFC tags” to view your automations grouped or categories “Notifications” or “NFC tags” to view your automations grouped or
@ -118,6 +118,7 @@
have different categories than the scene, scripts, or helpers settings page. have different categories than the scene, scripts, or helpers settings page.
aliases: aliases:
- categories - categories
link: /docs/organizing/categories/
- term: Climate - term: Climate
definition: >- definition: >-
The Climate entity allows you to control and monitor HVAC (heating, The Climate entity allows you to control and monitor HVAC (heating,
@ -263,7 +264,7 @@
link: /integrations/event link: /integrations/event
- term: Floor - term: Floor
definition: >- definition: >-
A floor in Home Assistant is a logical grouping of areas that are meant to A floor in Home Assistant is a [logical grouping](/docs/organizing/) of areas that are meant to
match the physical floors in your home. Devices & entities are not assigned match the physical floors in your home. Devices & entities are not assigned
to floors but to areas. A floor has properties such as: Floor ID, name, to floors but to areas. A floor has properties such as: Floor ID, name,
aliases (for use in assistants), an icon, and a floor level. Some of these aliases (for use in assistants), an icon, and a floor level. Some of these
@ -272,13 +273,14 @@
target for actions. For example, to turn off all the lights on the target for actions. For example, to turn off all the lights on the
downstairs floor when you go to bed. downstairs floor when you go to bed.
excerpt: >- excerpt: >-
A floor in Home Assistant is a logical grouping of areas that are meant to A floor in Home Assistant is a [logical grouping](/docs/organizing/) of areas that are meant to
match the physical floors in your home. Devices & entities are not assigned match the physical floors in your home. Devices & entities are not assigned
to floors but to areas. Floors can be used in automations and scripts as a to floors but to areas. Floors can be used in automations and scripts as a
target for actions. For example, to turn off all the lights on the target for actions. For example, to turn off all the lights on the
downstairs floor when you go to bed. downstairs floor when you go to bed.
aliases: aliases:
- floors - floors
link: /docs/organizing/floors/
- term: Frontend - term: Frontend
definition: >- definition: >-
The frontend is a necessary component for the UI, it is also where you can The frontend is a necessary component for the UI, it is also where you can
@ -405,7 +407,7 @@
- Intents - Intents
- term: Label - term: Label
definition: >- definition: >-
Labels in Home Assistant allow grouping elements irrespective of their Labels in Home Assistant allow [grouping](/docs/organizing/) elements irrespective of their
physical location or type. Labels can be assigned to areas, devices, physical location or type. Labels can be assigned to areas, devices,
entities, automations, scenes, scripts, and helpers. Labels can be used in entities, automations, scenes, scripts, and helpers. Labels can be used in
automations and scripts as a target for actions. Labels can automations and scripts as a target for actions. Labels can
@ -413,13 +415,14 @@
to show only devices with the label `heavy energy usage` or turn these to show only devices with the label `heavy energy usage` or turn these
devices off when there is not a lot of solar energy available. devices off when there is not a lot of solar energy available.
excerpt: >- excerpt: >-
Labels in Home Assistant allow grouping elements irrespective of their Labels in Home Assistant allow [grouping](/docs/organizing/) elements irrespective of their
physical location or type. Labels can be assigned to areas, devices, physical location or type. Labels can be assigned to areas, devices,
entities, automations, scenes, scripts, and helpers. Labels can be used in entities, automations, scenes, scripts, and helpers. Labels can be used in
automations and scripts as a target for actions. Labels can automations and scripts as a target for actions. Labels can
also be used to filter data. also be used to filter data.
aliases: aliases:
- labels - labels
link: /docs/organizing/labels/
- term: Lovelace - term: Lovelace
definition: >- definition: >-
Lovelace is the original code name of the UI that is now known as [Home Lovelace is the original code name of the UI that is now known as [Home

8
source/_docs/organizing/areas.markdown
View File

@ -18,7 +18,7 @@ related:
An area in Home Assistant is a logical grouping of {% term devices %} and {% term entities %} that are meant to match areas (or rooms) in the physical world of your home. An area in Home Assistant is a logical grouping of {% term devices %} and {% term entities %} that are meant to match areas (or rooms) in the physical world of your home.
For example, the "Living room" area groups devices and entities in your living room. Areas allow you to target an entire group of devices with an action. For example, turning off all the lights in the living room. For example, the "Living room" area groups devices and entities in your living room. Areas allow you to target an entire group of devices with an action. For example, turning off all the lights in the living room.
Areas can be assigned to floors. Areas can also be used to automatically generate cards, such as the [Area card](/dashboards/area/). Areas can be assigned to {% term floors %}. Areas can also be used to automatically generate cards, such as the [Area card](/dashboards/area/).
## Creating an area ## Creating an area
@ -29,7 +29,7 @@ Follow these steps to create a new area from the **Areas** view.
- Give the area a **Name** (required). - Give the area a **Name** (required).
- Add an icon (We use [Material icons](https://pictogrammers.com/library/mdi/)). - Add an icon (We use [Material icons](https://pictogrammers.com/library/mdi/)).
- Assign the area to a floor. - Assign the area to a floor.
- If you have not created floors yet, you can [create a new one](/docs/organizing/floors/#creating-a-floor). - If you have not created floors yet, you can [create a new floor](/docs/organizing/floors/#creating-a-floor).
- The number can be negative. For example for underground floors. - The number can be negative. For example for underground floors.
- This number can later be used for sorting. - This number can later be used for sorting.
- Add an image representing that area. - Add an image representing that area.
@ -43,11 +43,11 @@ Follow these steps to create a new area from the **Areas** view.
## Assigning areas to floors and add labels ## Assigning areas to floors and add labels
If an area has not yet been assigned to a floor, it is shown in the **Unassigned areas** section. Follow these steps to assign an area to a floor. If an area has not yet been assigned to a {% term floor %}, it is shown in the **Unassigned areas** section. Follow these steps to assign an area to a floor.
1. Go to {% my areas title="**Settings** > **Areas, labels & zones**" %} and select **Create area**. 1. Go to {% my areas title="**Settings** > **Areas, labels & zones**" %} and select **Create area**.
2. On the area card, select the edit {% icon "mdi:edit" %} button. 2. On the area card, select the edit {% icon "mdi:edit" %} button.
3. In the dialog, select the floor and add labels, if you like. 3. In the dialog, select the {% term floor %} and add {% term labels %} if you like.
## Assigning an area to multiple items ## Assigning an area to multiple items

8
source/_docs/organizing/floors.markdown
View File

@ -13,9 +13,9 @@ related:
title: Using floor alias for voice assistants title: Using floor alias for voice assistants
--- ---
A floor in Home Assistant is a logical grouping of areas meant to match your home's physical floors. A floor in Home Assistant is a logical grouping of {% term areas %} meant to match your home's physical floors.
Devices and entities cannot be assigned to floors directly but to areas. Floors can be used in automations and scripts as a target for actions. For example, to turn off all the lights on the downstairs floor when you go to bed. Devices and entities cannot be assigned to floors directly but to areas. Floors can be used in {% term automations %} and {% term scripts %} as a target for {% term actions %}. For example, to turn off all the lights on the downstairs floor when you go to bed.
## Creating a floor ## Creating a floor
@ -41,11 +41,11 @@ Follow these steps to create a new floor.
## Deleting a floor ## Deleting a floor
Follow these steps to delete a floor. Areas that are assigned to a floor will become unassigned. Automations and scripts or voice assistants that used a floor as a target will no longer work as they no longer have a target. Follow these steps to delete a floor. Areas that are assigned to a floor will become unassigned. {% term Automations %} and {% term scripts %} or voice assistants that used a floor as a target will no longer work as they no longer have a target.
1. Go to {% my areas title="**Settings** > **Areas, labels & zones**" %}. 1. Go to {% my areas title="**Settings** > **Areas, labels & zones**" %}.
2. Next to the floor, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Delete floor**. 2. Next to the floor, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Delete floor**.
![Screenshot showing the dialog to delete a floor](/images/organizing/floor_delete.png) ![Screenshot showing the dialog to delete a floor](/images/organizing/floor_delete.png)
3. If you have automations, scripts, or voice assistants that used floors as a target, you will need to update these. 3. If you have {% term automations %}, {% term scripts %}, or voice assistants that used floors as a target, you will need to update these.