# Sub-Device Dashboards

## Introduction

This feature allows enterprise customers to create multiple dashboards for their devices, with the ability to hide specific dashboards from end customers on white-labeled sites. This functionality provides greater control over what data is visible to different users.

### Video

{% embed url="<https://www.loom.com/share/29300e8d1d974ba2b82dc75af0eef886>" %}

***

## Key Features

1. **Multiple Dashboards**
   * You can now create multiple dashboard pages (or tabs) for a single device.
   * Each dashboard can contain different widgets, including device fields, charts, and downlinks.
2. **Visibility Control**
   * Dashboards can be marked as hidden on white-labeled sites, allowing you to create internal dashboards for service or management purposes.
3. **White Label Customization**
   * Only dashboards not marked as hidden will be visible to end customers on white-labeled sites.
   * The default dashboard remains mandatory and visible.
4. **Public Link Support**
   * Public links are only supported for the main (default) dashboard.

***

## How to Use

### Adding a New Dashboard

1. Navigate to the **Edit Mode** of your device dashboard.
2. Click the new **Add Dashboard** button.
3. In the modal that appears:
   * Provide a name for the new dashboard (e.g., "Service Dashboard").
   * Toggle the option to **Hide this Dashboard on White Label** if required.
4. Click **Add Dashboard**.
5. Your new dashboard will appear as a separate tab alongside the default dashboard.

### Adding Widgets to a Dashboard

1. Select the dashboard you want to edit.
2. Use the **Add Widget** button to add widgets such as:
   * Device fields
   * Chart widgets
   * Text widgets
   * Downlinks (optional)
3. Configure the widgets to suit the purpose of the dashboard.

### Managing Dashboard Visibility

* Dashboards marked as **Hidden on White Label** will not be visible to end customers accessing the white-labeled site.
* You can manage visibility for each dashboard independently.

***

## Example Use Cases

1. **Service Dashboards**
   * Create dashboards with detailed, complex data for internal teams (e.g., service or management staff).
   * Hide these dashboards from end customers.
2. **Customer-Facing Dashboards**
   * Design dashboards specifically for end customers, ensuring simplicity and relevance.
3. **Hybrid Dashboards**
   * Create dashboards visible to both internal teams and customers, containing shared data.

***

## Limitations

* The default dashboard cannot be removed and must always be visible.
* Public links are only supported for the main (default) dashboard.


---

# 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.datacake.de/dashboards/sub-device-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.