Resize and arrange widgets, switch data sources, and set chart and validation themes.
For page-level filters, operators, and how chips combine, see
Filters.
All widgets share common controls: Remove, Change Data Source, Full Screen, and
Settings. Chart widgets also offer Chart Style and Local Filters. Some chart
widgets allow visual customisation such as labels and margins in their settings. You can
drag widget edges or corners to resize. Use Section widgets to group parts of the
dashboard and improve navigation.
Change Data Source connects a data widget to another model already loaded on
the dashboard, and keeps the widget’s property bindings, filters, and chart options. Use
it when you have tuned an analysis on scheme A and want the same setup on scheme B without
rebuilding the widget.
- Model Viewer and Dual viewer are excluded — their models are managed separately. Change models
or versions on the viewer itself, or
re-pin the version from the
Sources sidebar.
- Property paths and filter rules that do not exist on the new source are kept and flagged,
not deleted. An empty chart often means the path is missing on the new source, not that
the widget lost its settings.
- Switching back usually restores those rules once the property exists again.
To remove a widget in editor mode, select the widget (click it), then open the menu (⋮) in
the widget sidebar and choose Delete, or press Delete (Del) on the keyboard.
Confirm in the dialog. The widget is removed from the dashboard.
Layout, widget positions, filter state, and pinned versions are saved with the dashboard.
Add sections to group areas
Drag Section from the widget panel onto the canvas to group areas (e.g. “Takeoff”,
“Validation”). Add widgets inside each section so related content appears together.
Resize widgets
Drag a widget edge or corner until its content fits. The widget displays at the new size.
Reorder widgets
Drag widgets by the header to reorder. Layout and filter state are saved with the dashboard.
Can I duplicate a widget?
Yes. Select the widget (click it), open the menu (⋮) in the widget sidebar, and choose
Duplicate. A copy of the widget is added to the canvas with the same settings.
Is there a limit to how many widgets I can add?
There’s no hard limit for most widgets, but dashboard performance may decrease with very large
numbers of widgets. 3D viewer widgets are the exception — see “Is there a limit to how many
3D viewer widgets I can add?” below.
Is there a limit to how many 3D viewer widgets I can add?
Yes. Widgets that render a 3D viewer or map each use one or more browser rendering contexts —
even an empty one with no model assigned yet. Browsers cap how many a page can hold open at once
(typically 16); once a dashboard reaches that limit, adding another such widget is blocked. This
is a browser-level limit, not a Speckle setting. Remove widgets you’re not using to stay under
it.
Why do some of my viewer or map widgets show a broken-image icon instead of loading?
This usually means the dashboard already has more 3D viewer or map widgets than your browser
allows open at once, for example on a dashboard created before the limit was enforced. Adding a
widget is blocked once you’re at the limit, but opening a dashboard that’s already over it still
loads every widget, so the extras fail instead. Remove the widgets you don’t need and reload the
dashboard to fix it.
Can I lock a widget or the layout?
Yes. Select the widget, open the menu (⋮) in the widget sidebar, and choose Lock widget. A
locked widget cannot be moved or resized. Choose Unlock widget from the same menu to allow
editing again.
Can I undo deleting a widget?
No. There is no undo for layout changes. If you delete a widget by mistake, add a new widget of
the same type from the sidebar and configure it again, or duplicate another widget if you have
one with similar settings.
Can I export a dashboard or widget (e.g. PDF, image, or chart data)?
Some widgets support export: tables can export to CSV, and Model Validation has its own
interface for importing and exporting rulesets and interop. There is no single “export
dashboard” to PDF or image for the whole dashboard.
Why is my dashboard slow?
Dashboards run in the browser and BIM models can be large—the browser and your device are the
main factors. Large models are slow to load, and all widgets depend on the data source loading.
Running many Model Validation rules (e.g. 2000) against a large model also takes time to
compute; results use page caching. Properties-over-time widgets use Speckle Automate to store
prior results.
How many models can I add to one dashboard?
There are no hard limits on data sources themselves, but see “Why is my dashboard slow?”—large
numbers of models or widgets can affect performance. If those models are shown in 3D viewer
widgets rather than just charts and tables, see “Is there a limit to how many 3D viewer widgets
I can add?” above.
Can I use IFC models in dashboards?
All ingested and published data in Speckle is Speckle data, regardless of original format (e.g.
IFC). You can use it in dashboards like any other model. Specialised widgets (e.g. for Revit,
Tekla) add features relevant to those sources; the underlying data is the same.
If I pin a version, does the dashboard ever change?
A pinned version stays fixed until you change it. From the Sources sidebar you can re-pin
or unpin a loaded model without
creating a new data source — widgets stay connected to that data source. The change saves the
dashboard immediately. Charts and tables recompute against the new version’s properties; paths
that only existed on the old version show no values until you select a property from the new
version. Can I compare more than two versions at once?
Yes. You can add multiple Model Viewer widgets or use widgets that support multiple data sources
to compare several versions. The Dual viewer widget compares two at a time; other widgets can
aggregate or compare across more sources.
Themes
Dashboard UI (light/dark) follows your workspace or system preference. Use the theme
toggle in the dashboard or workspace settings when available.
Chart and validation colors use the Themes panel in the dashboard sidebar. Open the
sidebar and select Themes to pick a built-in palette, or create and manage custom
themes for charts and pass/fail styling. The selected theme is saved with the dashboard.
Built-in and custom themes
Built-in themes are read-only presets. Custom themes live in one of three scopes:
- Dashboard Themes — this dashboard only
- Project Themes — dashboards that use models from that project
- Workspace Themes — all dashboards in the workspace
Who can create or edit depends on scope: dashboard edit access for dashboard themes;
project owner (or workspace admin) for project themes; workspace admin for workspace
themes.
On Dashboard Themes, use Generate random theme, Theme from image (samples
colors from a local image; the image is not uploaded), or New theme from current
(copies the active palette). Project and workspace sections offer New theme from
current when you have permission. To customize a built-in, select it, create a copy in the appropriate
scope, then edit the copy.
Click a custom theme once to apply it. Click the same theme again to show edit, delete,
and (for project or workspace themes) Copy to dashboard. In the editor you can rename
the theme, edit chart colors (including drag-and-drop reorder), and set Pass and
Fail colors used by validation widgets.
Category color mapping is consistent across widgets, so the same category keeps the same
color in different charts.
Color mode
Color mode on the Themes panel adjusts how colors appear for color-vision needs
(Off, Balanced CB, Protan/Deutan, Tritan). This affects display in your browser only — it
is not saved with the dashboard or into the theme.
See this video
for instructions on how to apply color coding and change the theme.
Last modified on September 19, 2026