diff --git a/source/dashboards/dashboards.markdown b/source/dashboards/dashboards.markdown index 613947c94ab..9135d57eacc 100644 --- a/source/dashboards/dashboards.markdown +++ b/source/dashboards/dashboards.markdown @@ -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.

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 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 diff --git a/source/dashboards/index.markdown b/source/dashboards/index.markdown index 16d37ec18cb..ba52d11d050 100644 --- a/source/dashboards/index.markdown +++ b/source/dashboards/index.markdown @@ -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/) \ No newline at end of file +- [Home Assistant cards](https://home-assistant-cards.bessarabov.com/) +