# Dashboards

### Overview

Dashboards put you in the driver's seat for managing and monitoring all your devices in one place. They allow you to bring together data from different devices and control them from a single dashboard. Even if they belong to different templates, you can work with them simultaneously.

For example, you can display the average temperature value from 10 devices on a single Label widget or turn on multiple devices in a single click.

<figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FHQCG7ULYc4kgeaOFAmzo%2F01_overview.avif?alt=media&#x26;token=b9713eb8-9c41-446e-9c9a-981f6703d452" alt=""><figcaption><p>Dashboards overview</p></figcaption></figure>

Watch the demo to see Blynk Dashboards in action, and find all the necessary documentation below.

{% embed url="<https://www.youtube.com/watch?t=898s&v=1PucugKB81I>" %}
Dashboards demo
{% endembed %}

### Dashboard Data Filtering

To accommodate various use cases, we have implemented a three-layered device filtering system that enables efficient data management for both small-scale and enterprise deployments.

#### Layer 1: Dashboard Data Source

Dashboard Data Source allows you to refine the devices that should be included to the dashboard by selecting specific templates and organizations.

For example, you have three different products: a heater, an air conditioner, and a fan. However, you want to build a dashboard only for heaters. In that case, you can select the corresponding template that contains heaters as the dashboard data source, ensuring that only such devices are included.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FGZLQXVqIDjt8hZkXPRTH%2F02_filters_datasource.png?alt=media&#x26;token=81366128-8006-4760-b02e-657beb69f5c6" alt="" width="372"><figcaption><p>Layer 1: Dashboard Data Source</p></figcaption></figure></div>

By default, the data source for the entire dashboard includes All devices (Templates = All, Organizations = All).  The Dashboard Data Source is editable anytime, but be careful as the changes affects all added widgets and may broke some of your settings.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2F4vUdKJIO6x3FerY8Kn6F%2F03_dash_datasource%20copy.avif?alt=media&#x26;token=a3cf0157-a3bd-40ed-9fce-2d9ca75b174a" alt="" width="375"><figcaption><p>Setting up data source for your dashboard</p></figcaption></figure></div>

#### Layer 2: Widget Data Source

By default each widget is assigned to All devices from your Dashboard Data Source.

However, you can narrow down the device selection for any widget.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2Fnuj6F0uAib5l2lpZAQTB%2F04_filters_perwidget.png?alt=media&#x26;token=d5c877be-f13b-40b2-8109-e7f6987ec503" alt="" width="372"><figcaption><p>Layer 2: Widget Data Source</p></figcaption></figure></div>

**To specify devices for the widget**:

* Open widget settings
* Navigate to Devices on a Data tab.
* Choose devices by selecting a segment bubble, applying filters, or picking them manually from the table.

Each widget may be assigned to a different subset of devices.

<figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FHmCivbikALmtwvB6WAyN%2F05_filters_perwidget1.avif?alt=media&#x26;token=cce54739-127c-44bc-ba16-fb8c2b255e9f" alt=""><figcaption><p>Devices that are assigned to the widget</p></figcaption></figure>

#### Segments

"**All**" segment is assigned by default. It means all devices corresponding the dashboard data source are assigned. **The segments in widgets contain only devices corresponding dashboard data source, other devices are filtered out.**

Next to the "All" there are other segments that were created on a Devices page.\
You can select any of these segments.

#### Filters

Also you can select devices by applying filters (e.g. Device name contains “heater”). The filters work the same as on the Devices page.

#### Manual Selection

To assign particular device(s) as a widget data source select it from the table. Once you select the first device, the new segment "Selected devices \[count]" appears.

You may select up to 50 devices.

#### Layer 3. Dynamic Filters

Dynamic filters are available in View mode after a dashboard is created and are accessible to all users with dashboard access. These filters allow users to temporarily focus on specific devices included in the dashboard. They do not affect other users and are reset after the page is reloaded. The Filters button is located in the top-right corner.

There are three dynamic filters: **Organizations**, **Templates**, and **Devices**. The filter options are based on the dashboard's data source.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FlvYes4xnHBv7A9sgueMp%2F06_filters_dynamic.avif.gif?alt=media&#x26;token=7d702857-092b-4fa5-bd3b-ad9e0c9064cd" alt="" width="384"><figcaption><p>Layer 3. Dynamic Filters</p></figcaption></figure></div>

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FgxuehTQvAfQxGNa5R1lO%2F07_filters_dynamic1.avif?alt=media&#x26;token=03a4fc82-9e65-4e94-bea7-14a76ac8d284" alt="" width="558"><figcaption><p>Apply dynamic filters to the dashboard</p></figcaption></figure></div>

### Creating a Dashboard

**Access Dashboard Page**: Go to the Dashboards page and click the **New Dashboard** button in the sidebar.

{% hint style="warning" %}
To create a dashboard you need to have a **Manage Dashboards** permission. Additionally you need to have **View Templates** permission to be able to work on a template level.
{% endhint %}

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FazSbxxDH1sRha2lwfOGl%2F08_create_dashboard.png?alt=media&#x26;token=d2c79260-c7c5-4a61-8e12-89b268f1bd1a" alt="" width="375"><figcaption><p>Creating a Dashboard</p></figcaption></figure></div>

The new dashboard will open in an empty state in Edit mode.

**Define Dashboard Data Source**:\
Firstly, we recommend to narrow down the list of devices included to the dashboard if you don’t need all of them. It will make the dashboard configuration faster and simpler for you. To do that click the **Change**... button inside a Dashboard **Data Source** box and select the desired templates and organizations.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FdIcuaxpmwxOn70yU9yNI%2F09_dash_datasource.avif?alt=media&#x26;token=33989017-c577-4a93-87d2-b777ba3db813" alt="" width="375"><figcaption><p>Select devices to include in the dashboard</p></figcaption></figure></div>

**Build Your Dashboard**: Add widgets from the Widget Box and configure them according to your needs. To add a widget double-click it or drag into the canvas.

<figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2F4DYeWJhBwy4QXwnUKZYT%2F10_edit_mode.png?alt=media&#x26;token=3fc8785b-cb7d-45a5-b07a-2233acc94e15" alt=""><figcaption><p>Add widgets from the Widget Box</p></figcaption></figure>

**Customize Dashboard Settings**: Rename dashboard by clicking on it and entering the name. Also, you can set a default date range that is relevant to your data and will apply every time you open the dashboard and manage who can see the dashboard.

**Save Your Dashboard**: Once you are satisfied with the dashboard view, click the Save Dashboard button in the top right corner. Congrats, your first dashboard is live.

**Manage Access**: By default, only roles with Manage analytics permission from the organization where the dashboard was created have an access. You can grant view access to other roles through the Manage Access menu either in Edit mode or options menu.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2F0gsKpYD8lJ08wBi50JUe%2F11_options_menu.avif?alt=media&#x26;token=0caede94-e0a9-4607-88a0-1631d940f82c" alt="" width="563"><figcaption><p>Options menu</p></figcaption></figure></div>

### Date range picker

You can find the date range picker under the Dashboard name.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FxxP1GEgSvoEfdo5hLTsu%2F19_date_picker.avif?alt=media&#x26;token=f48bb028-1544-4571-87bf-eb76a62d2582" alt="" width="563"><figcaption><p>Date range picker</p></figcaption></figure></div>

This picker allows you to analyze historical data across different periods. It includes predefined ranges such as:

**1d** - displays data for the last 24 hours.

**1w** - displays data for the last 7 days.

**1mo** - displays data for the last 30 days.

**3mo** - Displays data for the last 90 days.

**1y** - Displays data for the last 365 days.

{% hint style="warning" %}
Please note, the date range picker does not affect the **Control widgets** and the widgets showing **Latest value**. Regardless of the selected range, they operate the same.
{% endhint %}

### Managing Access

By default, only users with the **Manage Dashboards** permission in the organization where the dashboard was created can access it. These users can view and edit all dashboards in that organization.

{% hint style="info" %}
Please note that creating or editing a dashboard also requires the **View Template** permission.
{% endhint %}

You can grant **View** access to specific dashboards for additional users through the **Manage Access** option, available in the menu or **Edit mode**.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FjUmNn1UvdxXdqWGu7an4%2F20_options_menu%20copy.avif?alt=media&#x26;token=ee6a7c1a-f97e-4224-8af1-d8fbecbd4cbf" alt="" width="563"><figcaption><p>Manage access in the menu</p></figcaption></figure></div>

Dashboards can be shared with sub-organizations, allowing you to create a single dashboard and share it across all sub-orgs. However, shared dashboards can only be edited in the organization where they were created.

Access to a dashboard depends on the **organizations included in its data source**:

* **All Sub-Organizations**: The dashboard is shared with all sub-organizations.
* **Specific Organizations**: The dashboard is shared only with those selected organizations.
* **Current Organization Only**: The dashboard is not shared with sub-organizations.

<figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FnuEVeAZMjZ7NkeL8We62%2F21_manage_access.png?alt=media&#x26;token=e17f9840-c1c6-4ce8-8d5a-599b719fcfd0" alt=""><figcaption><p>Manage access</p></figcaption></figure>

### Setting a Dashboard as the Homepage

Normally, when you log into Blynk, you’d see the devices page first. Alternatively you can set a dashboard as the homepage for your organization.

By customizing your Homepage, you can ensure the data that matters most to you is always front and center. This makes it easier to keep track of key metrics, trends, and control devices.

**How to Set a Dashboard as the Homepage**:

1. **Open a dashboard**: Go to Dashboards and open the dashboard you want to set as the homepage.
2. **Open menu**: Find the Options menu in the top right corner.
3. **Set as homepage**: Choose the “Set as homepage” option from the menu.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FQOtftBy5RGUSJuPMtK2p%2F22_set_as_homepage.png?alt=media&#x26;token=c496690d-78e8-4c35-bbb9-7ad4585e4485" alt="" width="273"><figcaption><p>Set as Homepage</p></figcaption></figure></div>

The home icon appears at the top of the Main Navigation menu once you’ve set the homepage.

The homepage applies per organization, so each of your organizations can have its own homepage.

<div align="left"><figure><img src="https://1839001309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBFTVMf7L6S67HOuqVC%2Fuploads%2FGMA3ieHYZg2ucgpy4xq4%2F23_home.png?alt=media&#x26;token=683a6cd1-43b4-48dd-862a-adf8afaeb5e8" alt="" width="563"><figcaption><p>Dashboard as a Homepage</p></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blynk.io/en/blynk.console/dashboards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
