Get started
Access Dashboards
Create your first dashboard
Add a model viewer
Add analysis widgets
Configure interactions
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 with a swipe/slider reveal from one shared camera. 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
Change a pinned version
When a model has moved on and you want the same charts and tables to follow a different version — without deleting the source, remounting it, and re-pointing every widget — change the pin in place from the Sources sidebar.- Open Sources in the left sidebar.
- On the model row, choose Change version (or the pin control that lets you pick another version or latest).
- Confirm the new version (or unpin to track latest).
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.Dual viewer
Dual viewer compares two models or versions with a swipe/slider between panes. The cameras in both panes stay synced — you always navigate one shared viewpoint.- Both panes need a model before either side renders.
- Section box and measurements are not available on Dual viewer (they are misleading on a split view).
- Bottom view-mode controls drive the left pane; modes mirror to the right.
Context models
Use a context model when a model should appear in the 3D view for spatial reference but should not be affected by dashboard filters in that viewer. A site model, existing conditions, or surroundings mesh are typical examples when you are analyzing design schemes on the same canvas. By default, every model loaded in a Model Viewer is a data model. Dashboard filters isolate or hide objects in data models, and colorization from widgets applies to them. To mark a model as context:- Load two or more models in the same Model Viewer (sidebar Models → Add model).
- Select the viewer and open Models in the widget sidebar.
- Open the ⋯ menu on the model row.
- Choose Use as context model.
- Its geometry stays fully visible when page-level filters isolate objects in your data models.
- Filters that only target a context model are ignored by that viewer.
- Widget colorization driven by filters does not isolate or ghost context model objects.
Can I add multiple models to one dashboard?
Can I add multiple models to one dashboard?
Can I compare models from different software?
Can I compare models from different software?
Can I use models from projects where I'm only a viewer?
Can I use models from projects where I'm only a viewer?
When does dashboard data update?
When does dashboard data update?
How do dashboards relate to sync limits?
How do dashboards relate to sync limits?
What happens if a project or model I use is deleted?
What happens if a project or model I use is deleted?
Can I pass configuration values via the URL?
Can I pass configuration values via the URL?
?scenario=<id> so recipients open the same filters and colour-by. Other configuration (project, model, or arbitrary filter params) is not passed via the URL yet — tell us what you need via the Dashboards category on the Speckle Community or Intercom.When should I use a context model?
When should I use a context model?
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.Choosing the right widget
Use this table to pick a widget for what you want to do.Aggregation and numeric display
Total property value and Total value by property calculate with the method you pick in widget Settings → Aggregation:- Rounding — Always available. Options: 2 decimals (default), 1 decimal, 0 decimals, Auto, Locale, or Off.
- Display unit — Appears when the selected property (or ratio operand) has area units. Choose Source, m², ha, ft², or mm². Aggregation stays in source units; the widget converts for display, then rounds. Auto rounding may switch large areas to hectares (for example 12,500 m² → 1.25 ha).
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?
Can I build custom applications with Speckle dashboards?
Can I build custom applications with Speckle dashboards?
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.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?
Can I change the chart type after adding a widget?
Can I change the chart type after adding a widget?
Why are my chart labels overlapping or cut off?
Why are my chart labels overlapping or cut off?
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