Open a model
Large models use a hybrid load. A first overlay can show Preparing 3D stream or Downloading model. Once geometry starts painting, the overlay goes away and a progress stack in the top-right corner continues in the background. The downloaded copy is stored locally, so opening the same version again prefers that cache. You should see objects in the scene before the background download finishes.Find your way around
Panels are dockable. Drag a panel icon onto another panel to make a labelled tab group, split it into the bottom dock, collapse it, or resize it. On a first visit, Selection is open so the canvas is not empty.- Models, Filters, Views, and Issues sit in the left sidebar tab strip.
- Selection sits under those tabs by default and shows properties for the current pick.
- Elements sits in the bottom dock and lists every object in the loaded models.
- The status bar at the bottom holds panel icons, undo, redo, screenshot, shortcuts, and Settings.
- The navigation cube sits at the bottom-right of the canvas for canonical camera directions.
- Materials lists materials and colours in the loaded models. Select the usage count to pick the objects that use that material.
- Browse pages through tables in the published data.
- SQL runs a query against the attached models. $selected inserts the current pick’s application IDs.
- Inspector shows envelope relations as a diagram or rows, plus a raw property table. When nothing is selected it reads Select an object in the viewer to inspect its rows.
Use the Models card
Right-click the Models card header, or use ⋯, for Expand one level, Collapse one level, Group by…, Search this model, and Model placement. When the grouping strip is already open, Group by… becomes Hide grouping options. These verbs apply to the whole card, not to a tree row. When several models are federated, the same menu also offers Isolate model (or Un-isolate model, or Isolate model (partially isolated)), Hide model or Show model, and Remove from scene. Header glyphs show isolate and hide at a glance; they toggle the same state. Search this model opens a field on the card with the placeholder Search this model…. Model placement opens the inspect dialog described in Inspect model placement.Group objects in the tree
Group by… opens the grouping strip and its editor in one click. A collapsed strip shows Grouped by plus the current levels joined with ›. Select that summary to reopen the editor. The editor lists one row per tree level. Helper text reads Each row is a level of the tree — drag to renest. Drag the grip to reorder. Each row is a searchable picker; search with Search property or relationship…. Options show a label, a coverage count, and the full property path. Relationships such as Level, Collection, Model, and Network appear first when those relations exist. Properties follow; labels come from the path, so Family or Category appear when those paths are in the catalog. The default grouping is a spatial relationship (Collection or Level) over the highest-coverage property. Add grouping appends a row. Done collapses the editor. While the catalog loads, the strip can show Loading options…. If grouping is too fine to precompute, it reads Grouping too fine to precompute — the deepest level loads on expand.Select and inspect
Click geometry, or click rows in Models. Selection highlights both ways: the 3D pick reveals the tree row, and the tree row highlights in 3D. Open Selection with Shift+O. Selection shows properties for the pick. The title uses the first non-blank of name, type, or category. Property groups auto-expand. A Pinned group stays at the top when you pin a path. Revit material quantity blocks are condensed into readable rows named like Area or Volume. A Relations group at the bottom lists related objects by relation kind. Search the list with Filter properties. When nothing is selected, Selection shows No properties. From a property you can:- Add to filters — open an empty Filters card for that property. The scene does not narrow until you set the condition.
- Filter to this value — add a card already set to this value. The scene narrows immediately. Relation rows skip this action.
- Add as table column — add the path to Elements. If it is already a column, the menu reads Shown as a table column and opens Elements.
- Pin property or Unpin property.
- Copy value — copies the raw value, not the rounded display string.
- Copy path.
- Copy all properties — one
path: valueline per row. - Copy group path — from a group header that has a real path. Pinned and Relations have no path to copy.
- Expand all groups or Collapse all groups — on a single-object list. Multi-select cards fold from the toolbar instead.
Browse objects in Elements
Elements is a table of the objects in the loaded models. It follows the active Filters stack. Double-click a row to zoom to that object. When several models are loaded, a scope control can limit the table to one model or to the current selection.Open Elements
Inspect a row
Filter and color
Filters is a stack of property cards, not a single search box. Each card has operators that match the property type. Applied filters stay in place when you change selection or close and reopen panels. Open Filters with Shift+F. When the stack is empty, Filters shows No filters yet and an Add filter control. If the catalog fails, it shows Failed to load properties. If a resolve fails, it shows Failed to resolve filter matches. While a model is still attaching, it shows Attaching model…. Operators by property type:- String: is one of, is not one of, contains, does not contain, has value, is set, is not set.
- Number: equals, is not equal, in range, has value, is set, is not set. Numeric equals and is not equal accept more than one value. Equals tolerates small floating-point differences.
- Boolean: is (True / False), has value, is set, is not set.
- Relation (for example a level or network hop): is one of, is set, is not set.
Add a filter
Set the condition
Color by values
Save and apply views
Views lists two kinds of viewpoint in one panel. Open it with Shift+V.- Model views come from the source application when the connector published them. Select a row to fly the camera. These rows stay in Model views; converting one does not remove it. An orthographic published view can show a Parallel / orthographic (isometric) cue.
- Saved views are viewpoints you (or a teammate) stored in Speckle. The panel only lists views whose models are currently loaded. A view saved on an older version of a loaded model still applies.
Set the look
Save the view
Cut, measure, and sketch
The bottom toolbar holds Section, Sketch, and Measure. Shortcuts: Shift+B, Shift+K, and Shift+R. Press Esc to leave a tool. Cmd/Ctrl+Z undoes while sketching or measuring.Section planes
Sectioning is no longer a six-sided box around the model. You add individual section planes and move each one.Turn Section on
Add a plane
Adjust the cut
Measure
Types: Point to point, Perpendicular, Angle, and Area. Measurements stay on the canvas for the session. If you can save views, they are stored on the saved view with sketches. Without that permission they disappear when you leave the model.Sketch in 3D
Sketch draws on the model in 3D. Ink stays with the geometry as you orbit, pan, and zoom. It is stored on a saved view: saving the view keeps the markup, and opening that view restores it in place. Tools: Pen, Arrow, Revision cloud, Text, and Eraser. Preset ink colours are Red, Amber, Blue, Green, and White. Custom color adds any colour and opacity. Brush sizes sit next to the colours. Sketch is disabled without permission to save views.Navigation cube
The cube in the bottom-right of the canvas sets canonical directions. Alt+1–5 also move the camera to Top, Front, Left, Back, and Right. Fit and zoom still sit on the toolbar: Fit view to everything, or Zoom to selection when something is selected. Shift+Space does the same fit. Shift+P toggles orthographic projection. Explode, the older view-mode styles (Pen, Arctic, Shaded), and lighting controls are not on this toolbar. Projection and the grid are in Settings.Restore an issue’s view
Issues lists issues for the models in the scene. Open it with Shift+I. Opening an issue that was created in this viewer restores the camera, filters, and visibility stored with it. Select a card to apply that stored look. Right-click the card, or use ⋯, for Open issue page and Delete… when you can delete. Open issue page opens the full issue in a new tab. Create, assign, and field editing stay on Issues. The Issues tab is always in the strip. If the feature is not available on the project, the panel body shows that denial instead of a list. Empty states: No issues for this scene with New issue, No matching issues after search or chip filters, and Select an issue in the wide-dock detail pane.Inspect model placement
When several models are federated, Models can open Model placement for a model. That dialog shows the published placement, geometry storage, Project True North, and translation. Inspect placement option previews Internal Origin, Project Base Point, Survey Point origin, or Shared Coordinates.Keyboard shortcuts
Open the cheat sheet from the status bar or?. Bindings use Cmd on macOS and Ctrl elsewhere.
- Panels: Shift+M Models, Shift+F Filters, Shift+V Views, Shift+I Issues, Shift+T Elements, Shift+O Selection.
- Tools: Shift+R Measure, Shift+B Section, Shift+K Sketch.
- Camera: Shift+Space Fit view / zoom to selection, Shift+P Orthographic projection, Alt+1–5 standard views.
- Display: Shift+G Grid, Shift+X Reference points.
- History: Cmd/Ctrl+Z Undo, Cmd/Ctrl+Shift+Z Redo.
- Fly around: W A S D or arrow keys to move. E or Page Up moves up. Q or Page Down moves down. Hold Shift for faster, Alt for slower.
FAQ
Where did the section box go?
Where did the section box go?
Why is Sketch disabled?
Why is Sketch disabled?
Do measurements come back when I open a saved view?
Do measurements come back when I open a saved view?
What happens if I open a saved view from the previous viewer?
What happens if I open a saved view from the previous viewer?
Why does a filter hide the whole model?
Why does a filter hide the whole model?
Can I color the model from a numeric filter?
Can I color the model from a numeric filter?
Where did Set as home view and Replace view go?
Where did Set as home view and Replace view go?
Can I reposition federated models in the viewer?
Can I reposition federated models in the viewer?
Do Update parameters change the published model?
Do Update parameters change the published model?