> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt
> Use this file to discover all available pages before exploring further.
# Intelligence Dashboards
> Create interactive dashboards from your model data in Speckle.
Speckle Intelligence dashboards are available on your plan. For current limits and
pricing, see your workspace billing or the Speckle pricing pages.
Dashboards let you create custom, interactive views of your model data. Analyze properties, compare versions, and
share insights with your team—all without leaving Speckle.
If you blend model data with other sources, join the external data source blending
study on the [User testing opportunities
page](/get-involved/user-testing#external-data-source-blending).
If you are here for validation widgets specifically, use [Validation Widgets in
Dashboards](/analytics/dashboards/validation-widgets).
## Get started
From your Speckle workspace, click **Intelligence** in the top left to open the
workspace dashboards page. You can also open dashboards from within a project: open
the project, then click the **Dashboards** tab in the project navigation (with
Models, Issues, Automations, Collaborators, Settings).
Click **Add dashboard** to create a new dashboard. You'll be taken to the dashboard
editor.
Drag a **Model Viewer** widget from the left sidebar onto the canvas. Select a
project and model to display. The model viewer acts as the data source for other
widgets.
Drag additional widgets (charts, tables, etc.) from the left sidebar. Widgets will
automatically display data from the model you've added.
Click on widgets to configure their settings. Widgets can filter data, colorize the
model, and interact with each other.
## Dashboard navigation overview
The images below illustrate the structure and layout of the dashboard.
## Bring in your data
Your dashboard needs at least one model; the **Model Viewer** widget provides that data to every other widget. The
model viewer displays your 3D model; a **Dual viewer** widget lets you compare two models side by side.
In dashboards, each data source has a 1:1 relationship with a model loaded via a model viewer. Model-less data
sources are not yet supported.
### Adding models
To add a model:
1. Drag the **Model Viewer** widget onto the canvas
2. Select a project from the dropdown
3. Select a model from that project
4. Choose whether to load the latest version automatically or pin to a specific version
Use **latest** if you want the dashboard to update when new versions are published. Pin to a specific version if you
need to analyze a particular state of the model. You can add models from any project you have access to within the
workspace.
### Comparing models and versions
Some widgets support multiple data sources. You can compare different versions of the same model, models from
different disciplines, or models from different projects.
Widgets with multiple sources offer two modes:
* **Aggregate mode**: Combines data from all sources into a unified view. Use this to analyze data across multiple
models or versions together.
* **Compare mode**: Shows differences between sources. Use this to identify what's changed between versions or what
differs between models.
For supported widgets, compare mode can render results side by side so grouped distributions are easier to inspect
without switching context.
### Model viewer features and sync
The **Model Viewer** and **Dual viewer** widgets share the same 3D controls. Hover over a viewer to show the toolbars.
#### Top-right toolbar
* **Lock interactions**: Turn on to prevent pan, zoom, and orbit so viewers can be compared without accidental moves.
* **Save / load camera view**: Save the current view so the model loads at that angle next time; clear to reset.
* **Fit**: Frame the full model (or current selection) in view.
* **Projection**: Switch between perspective and orthographic.
#### Bottom toolbar
The bottom toolbar (Measure, Section, View modes, Light controls) matches the main Speckle 3D viewer. For details,
see [Interface and Navigation](/3d-viewer/interface-nav); for measure, section, and lighting in depth, see
[Exploration](/3d-viewer/exploration) and [Presentation](/3d-viewer/presentation).
#### Sync camera (sync views)
When the dashboard has at least two data sources (e.g. two model viewers, or a Dual viewer with two models), each
viewer widget has a **Sync camera** option in its sidebar. Turn **Sync camera** on for the viewers you want to keep in
sync. When sync is on, panning, zooming, or orbiting one viewer updates the others so you can compare models from the
same viewpoint. Sync requires at least two data sources; the option is disabled otherwise.
[See the video here on how to use sync camera.](/analytics/intelligence-dashboards#comparing-models-and-versions)
Yes. Add multiple model viewer widgets; other widgets can then connect to any of
them as their data source.
Yes. As long as both models are in Speckle, you can compare them. The comparison
works on shared properties between the models.
Yes. If you have access to the project you can add its models to a dashboard.
Dashboard data updates when you load or reload the page. If the model viewer uses
"latest", it fetches the latest version at that time.
Loading or refreshing a dashboard that displays model data counts as a **productive
receive** toward your workspace's monthly sync usage. So opening a dashboard or
reloading the page (when the model viewer fetches a version) consumes sync. For how
syncs are defined, how limits work, and how to view usage, see [Sync
Usage](/workspaces/new-plans-faq#sync-usage) in the [New plans
FAQ](/workspaces/new-plans-faq).
Dashboards are defined at the workspace level. If a project or model that a
dashboard uses is deleted, the dashboard will break—widgets that depend on that data
will no longer have a valid source.
No, not yet. If you have a use case (e.g. deep-linking to a project, model, or
filter), we'd like to hear about it. Tell us more via the [Dashboards
category](https://speckle.community/c/making-speckle/bashboards/79) on the Speckle
Community or Intercom.
### Widget groups in the sidebar
The widget panel in the dashboard editor groups widgets by category. Each group has a particular focus. **Model
Validation** lives in its own category (**Validation**) and is shown separately in the sidebar; availability may
depend on your workspace plan.
This section is for **dashboard-based validation widgets**. For that path, use
[Validation Widgets in Dashboards](/analytics/dashboards/validation-widgets). For
**Data Validation (checks and standards)**, use [Data Validation
Overview](/analytics/data-validation/overview).
| Group | Focus | Widget list |
| ------------ | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Viewer | Display and compare 3D models (single or two side by side). | Model viewer, Dual viewer |
| Presentation | Layout and content: sections, text, images, maps, embeds, AI renders. | Section, Text / Markdown, Image, Map, Embed, Render Genie |
| Basics | General analysis: counts, breakdowns by property, pivot/element tables, spot-check validation (Property checker). | Element count, Element table, Model Structure, Pivot table, Property Checker, Distinct values count, Total property value, Total value by property, Count by property |
| Revit | Analysis for Revit: levels, categories, types, families, materials, area, embodied carbon, quantities over time. | Levels, Categories, Types, Families, Area by name, Area by level, Embodied Carbon, Material quantities over time, Material stats, Material map |
| Tekla | Analysis for Tekla structural data: profiles, phases, weight. | Profiles, Phases, Weight by profile, Weight by material |
| CAD | Analysis for CAD sources (e.g. Rhino, AutoCAD): blocks and layers. | Blocks, Layers, Nested Blocks CAD (Beta) |
| ETABS | Cost estimation for ETABS models. | Cost Estimation |
| Grasshopper | Properties and outputs from Grasshopper-defined models. | Model Properties |
| Issues | Speckle Issues: overview, trends, and list views for issue tracking. | Issues Overview, Issues list |
| Validation | Rules-based validation: rulesets, Model Validation, detailed results. (Shown in its own section in the sidebar.) | Model Validation |
The exact groups and widgets you see depend on your workspace and connected data sources. Use the search box in
the widget panel to find a widget by name or description.
Experimental widgets are marked with a **Beta** badge in the widget panel so you can quickly identify features that
are still evolving.
### Choosing the right widget
Use this table to pick a widget for what you want to do.
| Goal / task | Widget list | Notes |
| --------------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Count how many elements (e.g. walls, doors) in the model | Element count 🔄 | No extra widget needed to slice: click a value in another chart to add a page filter; count updates. |
| Sum or average a numeric (e.g. area, length) across model | Total property value 🔄 | Shows both total and average. Property must be numeric; pick in widget. |
| See counts or totals by Category, Type, or Family | Count by property, Total value by property | Count by property = counts per group; Total value by property = sum or average per group. Revit: use Categories, Types, or Families. |
| Cross-tab by two or more properties (e.g. area by level and category) | Pivot table | Filter or limit categories first; large cross-tabs can be hard to read. |
| See the model as a tree (layers, blocks, discipline) | Model structure | Structure depends on source (e.g. Revit discipline, CAD layers). Expand/collapse; click to add page filter if enabled. |
| Count unique values for a property | Distinct values count | Use this to quickly measure cardinality (for example, unique types, systems, or names). |
| Browse or export element rows (custom columns, filter) | Element table | Export to CSV from the widget menu. Column choice is per widget. Chips appear at top; remove with X. No "clear all"; widgets can opt out of page filters in settings. |
| Run pass/fail rules (e.g. doors must have fire rating) | Property checker, Model Validation | For dashboard-based validation widgets, see [Validation Widgets in Dashboards](/analytics/dashboards/validation-widgets). For Data Validation (checks and standards), see [Data Validation Overview](/analytics/data-validation/overview). |
🔄 = supports **Compare mode** (multiple data sources).
#### How to connect a widget to a model
#### How to connect a widget to multiple models
Partially. You can customize dashboards with built-in **Text / Markdown**,
**Image**, and **Embed** widgets, and with **Themes** (chart and validation colors).
There is not yet a public API to build custom widgets that plug into the dashboard.
If you need custom widgets or integrations, get in touch via the [Dashboards
category](https://speckle.community/c/making-speckle/bashboards/79) on the Speckle
Community or Intercom. For custom applications built on dashboard capabilities
(Enterprise), see the next FAQ.
Yes. Enterprise customers have been working with us to deliver custom applications
via dashboard capabilities. [Build with
Speckle](https://speckle.systems/build-with-speckle) describes how we partner to
extend and embed Speckle. If you want custom dashboards, integrations, or embedded
analytics, get in touch via the [Dashboards
category](https://speckle.community/c/making-speckle/bashboards/79) on the Speckle
Community or Intercom.
### Chart types
Many widgets (Count by property, Total value by property, and others) let you switch between chart and list views.
Use the **Chart Style** or **Type** setting in the widget to choose how data is shown.
| Chart type | When to use | Preview |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| **Pie** | Parts of a whole, few categories (roughly 2–8). Avoid for many slices or precise comparison. | {/* IMAGE: Pie */} |
| **Bar** | Compare or rank categories. Works with many categories; easy to read exact values. Prefer over pie when precise comparison matters. | {/* IMAGE: Bar */} |
| **Tree (treemap)** | Hierarchical data or proportion of a whole with nested breakdown. Good when both size and grouping matter. | {/* IMAGE: Tree */} |
| **Grid** | Table view: exact numbers, multiple columns, sorting. Best for scan or export. | {/* IMAGE: Grid */} |
| **List** | Compact list of labels and values without a chart. Good for few items or limited space. | {/* IMAGE: List */} |
| **Drop down** | Compact selector for one or more values (multi-selection optional). Good for configuration or option-selection style dashboards (e.g. pick level or option to drive filters). | {/* IMAGE: Drop down */} |
| **Line** | Used by default in some widgets (e.g. time-based, version-over-time) for trends. Those widgets do not offer the same type switcher. | {/* IMAGE: Line */} |
Some chart widgets let you adjust margins and label placement. Select the widget,
open its **Settings** in the sidebar, and look for options such as margins, padding,
or label position. Increase margins or change the label setting so labels fit inside
the widget. If the widget has no label options, try resizing the widget or switching
to a different chart type (e.g. Grid or List) to see values in full.
Yes, for widgets that support multiple chart types. Use the **Chart Style** or
**Type** setting in the widget settings to switch between Pie, Bar, Tree, Grid,
List, or Drop down. Some widgets (e.g. time-based or version-over-time) use a fixed
chart type and do not offer this switcher.
Long labels or many categories can overflow the chart area. If the widget supports
it, adjust margins or label settings in the widget settings. Otherwise, resize the
widget, reduce the number of categories (e.g. with a filter), or switch to Grid or
List to see all values in a table.
### Property selection and the property library
You can choose which properties to display in two ways: inside a widget, or from the property library. You also
select properties when adding filters (e.g. filter by Category or Level); see [Filters](/analytics/dashboards/filters)
for filter levels and operators.
Many widgets (Count by property, Total property value, Element table, and others) prompt you to select one or
more properties for display. Use the widget's settings or property dropdown to pick the property; the widget
then shows values, counts, or breakdowns for that property.
es. How to Add an Element Table with Multiple Properties
The dashboard editor provides a **property library** that lists properties from your data sources. The library
is organised by data source: each model or data source has its own section. When you have multiple similar
data source types (e.g. several Revit models), the library is headed by a **shared properties** list—the
intersection of properties that exist across those sources.
Dragging a property from the library onto the canvas adds a generic chart or table widget configured to display that property's values.
Dragging a **shared** property uses data from all matching sources by default (aggregate); you can change the widget's data source
setting if you want to limit it to one source.
## Explore and filter
Filters let you focus on specific parts of your data. Chart and table widgets drive page-level filters (chips at the
top that affect all widgets) and optional widget-level filters (local to one widget). You can also colorize the 3D
viewer from widget data. Operators depend on the property's data type (text, number, list, boolean); filters combine
as OR within one chip and AND across chips. For full detail on filter levels, operators, properties, and colorizing
the model, see [Filters](/analytics/dashboards/filters).
When a widget value points back to a model data source, you can open that source in the viewer directly from the
dashboard flow to inspect context without leaving your analysis.
#### How to apply multiple filters using charts
#### How to color code and change color themes
## Organize and share
You can resize and reorder widgets, add **Section** widgets to group areas, and use the **Themes** panel for chart and
validation colors. Dashboards are shared at the workspace level; roles control who can view or edit. Duplicate a
dashboard to use it as a template. For layout steps, themes, sharing, and FAQs, see
[Layout and sharing](/analytics/dashboards/layout-and-sharing).
For step-by-step guides (quantity takeoff, portfolio analysis, finding a family), see
[Common workflows](/analytics/dashboards/common-workflows).
## Getting help
For questions about dashboards, visit the [Dashboards category](https://speckle.community/c/making-speckle/bashboards/79)
on the Speckle Community.