From e7ef3585d389aa9685a705b022778b8ab29b0ced Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Thu, 24 Apr 2025 23:48:13 +0200
Subject: [PATCH] Areas dashboard: add description (#38716)
---
source/dashboards/dashboards.markdown | 39 ++++++++++++++++--
.../dashboards/areas-dashboard-overview.png | Bin 0 -> 146812 bytes
.../dashboards/areas-experimental-dialog.png | Bin 0 -> 31144 bytes
3 files changed, 35 insertions(+), 4 deletions(-)
create mode 100644 source/images/dashboards/areas-dashboard-overview.png
create mode 100644 source/images/dashboards/areas-experimental-dialog.png
diff --git a/source/dashboards/dashboards.markdown b/source/dashboards/dashboards.markdown
index 9f8b9538534..5eca4135194 100644
--- a/source/dashboards/dashboards.markdown
+++ b/source/dashboards/dashboards.markdown
@@ -12,6 +12,10 @@ related:
title: Views
- docs: /dashboards/iframe/
title: Webpage card
+ - docs: /docs/organizing/
+ title: Grouping your assets
+ - docs: /docs/organizing/areas/
+ title: Grouping by areas
---
You can define multiple dashboards in Home Assistant. Each dashboard can be added to the sidebar. This makes it possible to create separate control dashboards for each individual part of your house.
@@ -27,6 +31,7 @@ Screenshot of the Dashboard list.
Home Assistant ships with some dashboards out of the box:
+- [Areas dashboard (experimental)](#areas-dashboard-experimental)
- Energy dashboard
- [History dashboard](#history-dashboard)
- [Logbook dashboard](#logbook-dashboard)
@@ -36,6 +41,27 @@ Home Assistant ships with some dashboards out of the box:
Not all of the predefined dashboards are listed under {% my lovelace_dashboards title="**Settings** > **Dashboards**" %}. The **Logbook** and **History** dashboards are powered by their respective integrations.
+### Areas dashboard (experimental)
+
+The **Areas** dashboard is prepopulated by default and shows your {% term entities %} [grouped](/docs/organizing/) by [areas](/docs/organizing/areas/).
+
+- It uses the [sections view](/dashboards/sections/) type and [tile cards](/dashboards/tile/).
+- The first view shows all your areas and the {% term entities %} that are [assigned to those areas](/docs/organizing/areas/).
+- In addition, the dashboard provides a separate view for each area.
+- {% term entities Entities%}, such as lights, covers, and cameras are automatically grouped by {% term domain %}.
+
+
+
+Screenshot of the Areas default dashboard.
+
+
+After you [added the dashboard](#creating-a-new-dashboard), you can edit the **Areas** dashboard:
+
+1. In the top-right corner, select the {% icon "mdi:pencil" %} icon.
+2. You can show or hide sections, rearrange the content, or [add badges](/dashboards/badges/).
+
+The **Areas** dashboard is still experimental. It is subject to change and may not always work as intended.
+
### History dashboard
The predefined **History** dashboard is powered by the [History integration](/integrations/history/). To learn about the data sources used and how to export data, refer to the documentation of the History integration.
@@ -84,21 +110,26 @@ This will leave the default dashboard intact.
2. Select **Add dashboard**.

3. In the dialog, choose one of the options:
- - If you want to start with a pre-populated dashboard, choose **Default dashboard**.
+ - If you want to start with a pre-populated dashboard, choose **Default dashboard** or one of the suggested ones, such as the **Areas** dashboard.
- If you want to start with a completely empty dashboard, choose **New dashboard from scratch**.
+ 
+
4. In the **Add new dashboard** dialog, enter a name and select an icon.
- Define if this dashboard should be visible only to the admin user.
- Define if you want the dashboard to be listed in the sidebar.
- Select **Create**.
- **Result**: The dashboard is added.
-5. Open your new dashboard and in the top right of the screen, select the
button.
-6. If you chose **Default dashboard**, you need to take control before you can edit it:
+
+## Editing a new dashboard
+
+1. Open your new dashboard and in the top right of the screen, select the {% icon "mdi:pencil" %} button.
+2. If you are editing a **Default dashboard** for the first time, you need to take control before you can edit it:
- The **Edit dashboard** dialog appears.
- By editing the dashboard, you are taking over control of this dashboard.
- This means that it is no longer automatically updated when new dashboard elements become available.
- Once you've taken control, you can't get this specific dashboard back to update automatically. However, you can create a new default dashboard.
- To continue, in the dialog, select the three dots {% icon "mdi:dots-vertical" %} menu, then select **Take control**.
-7. You can now [add a card](/dashboards/cards/#adding-cards-to-your-dashboard) or [add a view](/dashboards/views/#adding-a-view-to-a-dashboard).
+3. You can now [add a card](/dashboards/cards/#adding-cards-to-your-dashboard) or [add a view](/dashboards/views/#adding-a-view-to-a-dashboard).
## Deleting a dashboard
diff --git a/source/images/dashboards/areas-dashboard-overview.png b/source/images/dashboards/areas-dashboard-overview.png
new file mode 100644
index 0000000000000000000000000000000000000000..aa71244df1a8f9d69265830828ddd20badd33ec6
GIT binary patch
literal 146812
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