Speckle Intelligence dashboards are available on your plan. For current limits and pricing, see your workspace
billing or the Speckle pricing pages.
Get started
Access Dashboards
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).
Create your first dashboard
Click Add dashboard to create a new dashboard. You’ll be taken to the dashboard editor.
Add a model viewer
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.
Add analysis widgets
Drag additional widgets (charts, tables, etc.) from the left sidebar. Widgets will automatically display data
from the model you’ve added.
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:- Drag the Model Viewer widget onto the canvas
- Select a project from the dropdown
- Select a model from that project
- Choose whether to load the latest version automatically or pin to a specific version
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.
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; for measure, section, and lighting in depth, see Exploration and 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.Can I add multiple models to one dashboard?
Can I add multiple models to one dashboard?
Yes. Add multiple model viewer widgets; other widgets can then connect to any of them as their data source.
Can I compare models from different software?
Can I compare models from different software?
Yes. As long as both models are in Speckle, you can compare them. The comparison works on shared properties
between the models.
Can I use models from projects where I'm only a viewer?
Can I use models from projects where I'm only a viewer?
Yes. If you have access to the project you can add its models to a dashboard.
When does dashboard data update?
When does dashboard data update?
Dashboard data updates when you load or reload the page. If the model viewer uses “latest”, it fetches the latest
version at that time.
How do dashboards relate to sync limits?
How do dashboards relate to sync limits?
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 in the New plans FAQ.
What happens if a project or model I use is deleted?
What happens if a project or model I use is deleted?
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.
Can I pass configuration values via the URL?
Can I pass configuration values via the URL?
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 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.| 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, 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 |
| 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 |
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. |
| 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 | See Data Validation for rules and rulesets. |
How to connect a widget to a model
How to connect a widget to multiple models
Can I make my own widgets?
Can I make my own widgets?
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 on the Speckle Community or
Intercom. For custom applications built on dashboard capabilities (Enterprise), see the next FAQ.
Can I build custom applications with Speckle dashboards?
Can I build custom applications with Speckle dashboards?
Yes. Enterprise customers have been working with us to deliver custom applications via dashboard capabilities.
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 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. | |
| Bar | Compare or rank categories. Works with many categories; easy to read exact values. Prefer over pie when precise comparison matters. | |
| Tree (treemap) | Hierarchical data or proportion of a whole with nested breakdown. Good when both size and grouping matter. | |
| Grid | Table view: exact numbers, multiple columns, sorting. Best for scan or export. | |
| List | Compact list of labels and values without a chart. Good for few items or limited space. | |
| 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). | |
| 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. |
The labels in my chart are outside the widget and I can't read them. What can I do?
The labels in my chart are outside the widget and I can't read them. What can I do?
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.
Can I change the chart type after adding a widget?
Can I change the chart type after adding a widget?
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.
Why are my chart labels overlapping or cut off?
Why are my chart labels overlapping or cut off?
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 for filter levels and operators.- In a widget
- Property library
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