Add procedure on creating a new dashboard (#31875)

* Add procedure on creating a new dashboard

* Tweaks

* Update link to procedure

* Update related topic
This commit is contained in:
c0ffeeca7 2024-03-18 09:39:17 +01:00 committed by GitHub
parent ef4a64ff1b
commit 85f7caa062
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 32 additions and 8 deletions

View File

@ -5,7 +5,7 @@ description: "Multiple powerful and configurable dashboards in Home Assistant."
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.
You can manage your dashboards via the user interface. Go to {% my lovelace_dashboards title="**Settings** > **Dashboards**" %}. Here you can see some of the defined dashboards and create new ones.
Under {% my lovelace_dashboards title="**Settings** > **Dashboards**" %}, you can see your own dashboards and some of the predefined ones.
<p class='img'>
<img src='/images/dashboards/dashboard-manage-01.png' alt='Screenshot of the dashboard list'>
@ -22,7 +22,7 @@ Home Assistant ships with 5 predefined dashboards:
- Logbook
- History
Not all of predefined dashboards are listed under {% my lovelace_dashboards title="**Settings** > **Dashboards**" %}. **Map**, **Logbook**, and **History**, are powered by their respective integrations.
Not all of the predefined dashboards are listed under {% my lovelace_dashboards title="**Settings** > **Dashboards**" %}. **Map**, **Logbook**, and **History**, are powered by their respective integrations.
### Map dashboard
@ -34,7 +34,32 @@ The predefined **Logbook** dashboard is powered by the [Logbook integration](/in
### History dashboard
The predefined **History** dashboard is powered by the [History integration](/integrations/logbook/). To learn about the data sources used and how to export data, refer to the documentation of the History integration.
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.
## Creating a new dashboard
The default **Overview** dashboard updates itself when you add new devices, as long as you do not edit the default dashboard. If you want a customized dashboard, it is recommended not to change the **Overview** dashboard, but to create a new dashboard instead.
This will leave the default dashboard intact.
1. Go to {% my lovelace_dashboards title="**Settings** > **Dashboards**" %}.
2. Select **Add dashboard**.
![Screenshot of the dashboard list](/images/dashboards/dashboard-manage-02.png)
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 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 <img height="28px" src="/images/blog/2024-03-dashboard-chapter-1/mdi-edit.png" alt="Edit icon"/> button.
6. If you chose **Default dashboard**, 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.
- To continue, in the dialog, select the three dots 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).
## Using YAML for the Overview dashboard

View File

@ -23,9 +23,7 @@ Try it yourself with [the interactive demo](https://demo.home-assistant.io).
## Get started with your own dashboard
{% include dashboard/edit_dashboard.md %}
For more detailed instructions, follow the step-by-step tutorial on [editing the **Overview** dashboard](/getting-started/onboarding_dashboard/).
To create your own dashboard, follow the steps on [creating a new dashboard](/dashboards/dashboards/#creating-a-new-dashboard).
## Discuss dashboard
@ -36,10 +34,11 @@ For more detailed instructions, follow the step-by-step tutorial on [editing the
- [Dashboard themes](/integrations/frontend/#defining-themes)
- [Interactive dashboard demo](https://demo.home-assistant.io)
- [Editing the **Overview** dashboard](/getting-started/onboarding_dashboard/)
- [Creating a new dashboard](/dashboards/dashboards/#creating-a-new-dashboard)
### Cards
- [About cards](/dashboards/cards/)
- [Community custom cards](https://github.com/custom-cards)
- [Home Assistant cards](https://home-assistant-cards.bessarabov.com/)
- [Home Assistant cards](https://home-assistant-cards.bessarabov.com/)