---
updatedAt: 2025-08-14T10:47:59.000Z
agentTools:
  projectIndex: https://docs.lumeo.com/llms.txt
---

# Dashboards

Lumeo Dashboards are flexible, multi-modal dashboards that make it easy to visualize video and analytics data for security, business and operational insights.

![](https://files.readme.io/0e25be5-dashboard.png)

# Creating a Dashboard

> 🚧 Plan Restrictions
>
> The Starter Plan comes with the ability to create 1 Dashboard. Business & Enterprise Plans can create Unlimited Dashboards.

Start by creating a Dashboard using the "Create Dashboard" button on the top right menu. You can create a blank dashboard, or pick from a range of dashboard templates available to get started.

> Tip: If you have deployed pre-built analytics templates, refer to the analytic template description for corresponding Dashboard templates that work with the analytics you have deployed.

Once created, you can Rename, Duplicate or Delete the Dashboard using the context menu in the Dashboard list in the left navigation.

<img src="https://files.readme.io/a71d5566934b74c438a0f45fa05006070cfee879166e086a332ed6889508d44e-dashboard-templates-1.png" align="center" />

<br />

# Filtering dashboard data and media

All the data in a Dashboard can be filtered by one or more of these attributes:

* Time : Select a start date and end date, a particular timezone or a preset to filter by time
* Gateway : Select a gateway to filter data to that generated by a specific Gateway
* Source Labels : Select a Label to filter data to that generated by analytics running on sources that are tagged with that Label or it's descendants. You can create labels and tag sources under the Deploy section. This is a very powerful capability since it lets you visualize a single Dashboard by your custom hierarchy (such as by Region, Customer or Area).

<img src="https://files.readme.io/e775fb127ffef3a01049864f41d9a579eb7706eaf417d8a858dff256e4e7c246-dashboard-filters-1.png" align="center" />

<br />

# Widgets

Each Dashboard consists of Widgets that you add and configure.

<img src="https://files.readme.io/b996a1666a08d1a29d8d6e2771d1df7f31722a27ff489a4ab93955f8f660344d-widget-add.png" align="center" caption="Add Widgets by clicking Add widget on the top right corner" />

<br />

Widgets can be resized and dragged to create the perfect layout using the "Edit Layout" button on the Dashboard.

<img src="https://files.readme.io/cbaadc16b8225ac86178d1905b6f4da94e6e0d9d0a308cc65eef83b47c90be39-widget-layout-1.png" align="center" caption="Adjust layout by clicking Edit Layout on the top right corner" />

<br />

Widget properties can be updated from the Widget context menu. You can easily Duplicate or remove widgets from here as well.

<img src="https://files.readme.io/54ef9f46c0f8f7c532a100ed2ba831a3335da4bb09a176971c30007cdb6728a4-widget-edit.png" align="center" caption="Edit a Widget's properties by clicking Edit on the Widget context menu" />

<img src="https://files.readme.io/e77c725c289f76df107be163859f753ea87ce2e1a142c04bbfce41ba27cce46f-widget-filters-1.png" align="center" caption="Customize widget properties and filters" />

<br />

## Data

A Data widget visualizes analytics metadata that has been published from a [Pipeline](https://docs.lumeo.com/docs/pipeline) using a [Publish to Lumeo Dashboard](https://docs.lumeo.com/docs/publish-to-lumeo-dashboard-node) Node.

<img src="https://files.readme.io/3c66c4e-data-widget.png" align="center" caption="Data Widget Examples" />

> 🚧 Plan Restrictions
>
> The [Publish to Lumeo Dashboard](https://docs.lumeo.com/docs/publish-to-lumeo-dashboard-node) node that is needed to publish data for this widget is available only on Enterprise Plans.

### Publish to Lumeo Dashboard Node Configuration

The [Publish to Lumeo Dashboard](https://docs.lumeo.com/docs/publish-to-lumeo-dashboard-node) Node can publish 3 types of metadata to the Dashboard. See Node documentation for how to configure it.

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;">Metadata Type</th>
  <th style="border: 1px solid #ddd; padding: 8px;">Description</th>
  <th style="border: 1px solid #ddd; padding: 8px;">When to Use</th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Node Metadata</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>This includes Node-specific metadata such as <a href="doc:line-crossing-counter-node">Line Counter Node</a>&#39;s line crossing metadata or <a href="doc:occupancy-monitor-node">Occupancy Monitor</a> node&#39;s occupancy metadata. Refer to Node&#39;s documentation for information on what metadata is published to the Dashboard.</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Use it to publish Node-specific stats such as line crossings, or occupancy numbers. </p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Object Attributes Metadata</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>This includes object types and object attributes that are added to an object by <a href="doc:ai-model-node">AI Model Node</a> or specific Recognition nodes.</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Use it to capture and display attributes (such as license plate numbers, vehicle types, barcode values, colors, etc.)  </p>
<p>Note that if you are just trying to count object attributes you are better served by using the Node Metadata instead of publishing Object Attributes. </p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Event Metadata</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>This publishes an event to the Dashboard (ex using a <a href="doc:trigger-an-event-node">Trigger an Event</a> node) every time specific <a href="doc:trigger-conditions">Trigger Conditions</a> are met.</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Use it to publish counts of custom events that are not already being published by Node metadata -- such as a car making an illegal left turn.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### Visualization Options

<img src="https://files.readme.io/fd09c35-alt-data-widget.png" align="center" />

The Data widget offers the following visualization options:

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;">Configuration Option</th>
  <th style="border: 1px solid #ddd; padding: 8px;">Option Value</th>
  <th style="border: 1px solid #ddd; padding: 8px;">Description</th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Metric</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Event Count</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Count the number of Events published using the Event Metrics properties of the <a href="doc:publish-to-lumeo-dashboard-node">Publish to Lumeo Dashboard</a> node.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Object Attribute Count &amp; Object Attribute Count (Distinct)</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Count the number of Object attributes published using the Object Attribute Metrics properties of the <a href="doc:publish-to-lumeo-dashboard-node">Publish to Lumeo Dashboard</a> node.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Node Records Count</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Count the number of Node Metrics published using the Node Metrics properties of the <a href="doc:publish-to-lumeo-dashboard-node">Publish to Lumeo Dashboard</a> node.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;">

&lt;Node Specific Metadata Aggregations&gt;
ex.
Occupancy : Object Entered Sum <br />
Line Counter: Total Objects Crossed Sum

</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>For each supported Node type, a Metric that aggregates specific node data is listed here.  </p>
<p>Typically, this is used along with a Metric-specific Dimension or Filter, with suggestions available in those dropdowns.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Display Type</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Bar</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Line</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Stacked Bar Chart</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Grouped Bar Chart</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Leaderboard</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Heatmap</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Table</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Pie</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Number</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Granularity</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>HOUR, MINUTE, DAY, MONTH, FIVE_MINUTES, FIFTEEN_MINUTES</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Time granularity to use for Time displays (Bar, Stacked Bar and Line). </p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Dimensions</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Common: Source ID, Source Name, Gateway ID, Gateway Name, Pipeline ID, Pipeline Name, Deployment ID, Deployment Name, Source Type, Metrics Tag  </p>
<p>Metric-specific Dimensions (such as Line Label, ROI Label, Event Type)</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Series values to use for Stacked Bar, Leaderboard and Table displays. </p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Row Limit</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Numeric. Ex. 10</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Maximum number of rows/series values for Stacked Bar, Leaderboard, Table displays.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Sort</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Ascending, Descending</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Sort order to use</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><strong>Filters</strong></p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Common: Source ID, Source Name, Gateway ID, Gateway Name, Pipeline ID, Pipeline Name, Deployment ID, Deployment Name, Source Type, Metrics Tag  </p>
<p>Metric-specific Filters (such as Line Label, ROI Label, Event Type)</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Filter the metadata being displayed using these conditions to limit to a specific source, pipeline, line, ROI or Metrics Tag.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

## Stream

Stream Widget displays a RTSP or WebRTC stream output from a pipeline with a [Stream RTSP](https://docs.lumeo.com/docs/stream-rtsp-node) node or [Stream WebRTC Node](https://docs.lumeo.com/docs/stream-webrtc-node).

<img src="https://files.readme.io/822db58-stream-widget.png" align="center" caption="Stream Widget" />

| Configuration Option | Option Value                    | Description                 |
| :------------------- | :------------------------------ | :-------------------------- |
| **Stream ID**        | WebRTC streams and RTSP streams | Pick the stream to display. |

## Multi Stream

Multistream Widget displays WebRTC streams output from multiple pipelines, chosen with a filter criteria. It is useful when you want to build video walls without having to manually add each Stream.

<img src="https://files.readme.io/08e7231-multi-stream-widget.jpg" align="center" caption="Multistream widget" />

| Configuration Option         | Option Value  | Description                                                       |
| :--------------------------- | :------------ | :---------------------------------------------------------------- |
| **Show Online Streams Only** | True/False    | If True, only display online WebRTC streams.                      |
| **Filters**                  | Gateway ID    | Display WebRTC Streams being processed by the specified Gateways. |
|                              | Deployment ID | Display WebRTC Streams output by specified Deployments.           |
|                              | Stream ID     | Display WebRTC Streams specified by these Stream IDs              |
|                              | Stream name   | Display WebRTC streams whose names contain specific text.         |

## Files

Files Widget displays recordings generated by [Save Clip Node](https://docs.lumeo.com/docs/save-clip-node) and [Save Snapshot Node](https://docs.lumeo.com/docs/save-snapshot-node) that match a specific filter criteria, making it easy to shortlist files for review. For each file, the widget displays the Pipeline and Source that generated the file.

Clicking on a file in the Files widget plays it immediately in the browser.

<img src="https://files.readme.io/f713d5d-files-widget.png" caption="Files Widget" align="center" />

| Configuration Option | Option Value  | Description                                              |
| :------------------- | :------------ | :------------------------------------------------------- |
| **Filters**          | Gateway ID    | Display files captured on these Gateways                 |
|                      | Deployment ID | Display Files generated by these deployments             |
|                      | Stream ID     | Display Files generated by these input streams           |
|                      | Pipeline      | Display Files generated by these Pipelines               |
|                      | Node IDs      | Display Files generated by these nodes within a PIpeline |
|                      | Camera        | Display Files generated by these Cameras                 |

## IFrame

Iframe Widget displays a web page inside an IFrame. It is useful to display external data or reports, say from an external BI system, within Lumeo for a single pane of glass.

<img src="https://files.readme.io/107552d-iframe-widget.png" align="center" caption="Elasticsearch dashboard embedded within an IFrame" />

<br />

<br />

# Custom Dashboard Creation Guide

The guide below shows you how to build an analytic and a custom dashboard that goes with it.

<iframe src="https://www.loom.com/embed/19730a3b734543ceb2624da474c43450?sid=68dcb46f-fd57-4959-b428-7208d4a9eab6" width="100%" height="501" frameBorder="0" allowFullScreen title="Loom Video Embed" />