> ## 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.
> ## Agent Instructions
> These docs contain multiple Speckle product experiences. For Speckle 2026.9, prefer /next/ pages for the topics and changes they cover. The navigation label Current does not override this version-specific precedence.
> Coverage under /next/ is incremental. Use Current documentation for unchanged topics and when a /next/ page says coverage is unavailable or explicitly refers you to Current. Do not infer a feature was removed from a missing page.
> Read the page-specific documentation status, applicability, affected guidance and replacement links in agent-only content. Impacted, changed and superseded apply only to the stated scope; they do not mean the entire feature is deprecated. Historical connector guides apply only to the legacy connector described.
> Match guidance to the customer's deployment version, model data format and connector. Respect plan, permission and compatibility restrictions. If an unknown version or data format changes the answer, ask a focused clarification; do not infer deployment version from the date alone.
# 3D viewer in 2026.9
> What changed when you open a model in the 2026.9 web app — Selection, Filters, Views, section planes, and the new panel chrome.
Documentation set: Speckle 2026.9. Status: current. Authority: canonical for this version and the coverage on this page.
Applies to version 2026.9, from 2026-09; this is not a rollout date for every deployment.
Authoritative Speckle 2026.9 documentation for the topic covered here. For Speckle 2026.9, prefer this page over conflicting earlier guidance. Follow the linked pages in the other documentation version for unchanged topics and where this page says coverage is not yet available. Respect data-format, deployment, plan, permission, and compatibility limitations stated in the page.
This is 2026.9 documentation. Coverage here is incremental: a page exists only where 2026.9
differs or is newly documented. For any other topic, switch to **Current** (2026.8 and earlier) in
the version selector.
Opening a model in the 2026.9 web app uses a new 3D viewer. Geometry starts appearing while the
full file is still downloading. **Selection**, **Filters**, and **Views** sit in dockable panels,
and sectioning uses cutting **planes** instead of a box.
This page covers only what changed. For interface basics that still apply — sharing, federation
from the project, and issue fields — see [Interface and navigation](/3d-viewer/interface-nav),
[Exploration](/3d-viewer/exploration), [Saved views](/3d-viewer/saved-views),
[Issues](/3d-viewer/issues), and [Share your models](/3d-viewer/sharing).
Embedded models show only the 3D scene for now. The model tree, **Filters**, selection details,
and the viewer toolbar do not appear inside an embed yet, whichever embed options you choose. This
is a known limitation. Open the model in the web app to filter, select, or measure.
To ask questions about the models loaded in this viewer, use the sparkle. That flow is on
[Ask questions about your models with Speckle Intelligence](/next/analytics/intelligence).
The 2026.9 viewer requires WebGPU. There is no fallback. Firefox on macOS currently allows eight
GPU storage buffer bindings, and the viewer needs nine, so models will not open there — use
Chrome, Edge, or Safari.
## 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.
Point clouds do not render in this viewer yet. Everything else in the model loads normally, and
your point cloud data is unchanged — the points are not drawn. Support is planned for a later
release.
Some colours and materials do not render in this viewer yet. Affected objects show as flat grey,
even though the colour is in the published data. Known cases are coloured meshes and geometry with
a **Color** input from Grasshopper, Civil 3D surfaces with materials, and models published before
your project moved to the 2026.9 data format. Your data is unchanged, and connectors that load the
model keep the colours. This is a known issue we are working on.
## 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.
The status bar **Settings** menu holds **Orthographic**, **Grid**, and **Reference points**.
**Layout** in that menu lists every panel as a checkbox. **Models** stays on. **Lock layout**
stops accidental drags. **Reset layout** restores the default arrangement after you unlock.
Right-click a panel icon in the tab strip or status bar to move it. The menu lists only slots
that panel can occupy: **Move to sidebar**, **Move to sidebar bottom**, **Move to bottom
panel**, or **Move to bottom right**. **Remove panel** hides it; turn it back on from
**Layout**. **Models** has no **Remove panel**. With **Lock layout** on, the move verbs are
omitted.
These panels start hidden. Turn them on from **Settings** → **Layout**:
* **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**.
On narrower widths the left sidebar becomes a slide-over.
Right-click the canvas for **Hide** or **Show**, **Isolate** or **Un-isolate**, **Fit to
view**, **Copy application ID**, **Add to chat**, and **Clear selection**. With more than one
object selected, **Hide** and **Isolate** (and their opposites) become **Hide selection** and
**Isolate selection** (or **Show selection** and **Un-isolate selection**), and the chat verb
reads **Add selection to chat**. Right-click a row in **Models** for the same
verbs except **Copy application ID**. Right-click a scene-tree group to pin that group; the
verb then reads **Add "{label}" to chat**, using the group's name. Right-click a selected
object keeps the whole selection. Right-click an unselected object replaces the selection with
that pick. **Add to chat** pins the pick for Speckle Intelligence. If too many objects are
selected to pin individually, a toast reads **Too many objects selected to add individually**
and tells you to right-click a scene-tree group instead.
### 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](#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.**
**Keyboard shortcuts** opens from the status bar, or from `?`. That cheat sheet is the
authoritative list, including fly keys (W A S D, E and Q) and Alt+1–5 for standard views.
## 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
**{Material} Area** or **{Material} 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: value` line 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.
When you select several objects, **Selection** shows one card per object. Each card can zoom,
isolate, or hide that element. In a wide dock the cards sit in columns. Fold or expand all
cards from the toolbar. The count reads **N selected**. Selections larger than 1,000 objects
start folded; you can still open one card at a time.
Use **Show all** on the toolbar when objects are hidden or isolated.
### 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.
Select **Elements** in the bottom dock, or use Shift+T. You should see a table of objects and a
count.
Select a row. **Selection** shows that object's properties. Double-click the row to frame it in
the scene.
**Export view to Excel** downloads the current columns, filter scope, and sort. If grouping or
search is too large, a warning reads **Showing the first … elements — narrow the scope (filters
or selection) for a complete view**.
**Update parameters** turns columns whose path starts with **properties.** into editors. Other
columns stay read-only and show a lock icon in the header. Staged edits do not change the
published version. **Submit change requests** creates an issue that carries those deltas, so
teammates can review the proposed values. Creating that issue needs permission to create issues
on the project.
When **Update parameters** is on and the table has 15 or more elements, **Search rows…** appears
and narrows the table. It is not on the browse toolbar.
Only **properties.** columns become editors. Name, category, and similar columns stay read-only.
## 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**.
**Has value** matches objects where the property has a non-empty value. **Is set** matches
objects where the property exists. **Is not set** matches objects where it is missing.
Open **Filters** and select **Add filter**. Choose a property. An empty card appears in the
stack. The scene does not change yet.
Choose an operator and the values to include or exclude. The scene then narrows to matches. If
nothing matches, **Filters** shows **No objects match — everything is hidden**.
On a string or relation card, select **Color by values**. Matching objects take colors for those
values. Only one card colors the scene at a time. Numeric and boolean cards do not color the
scene.
With two or more cards, **All** keeps objects that match every card. **Any** keeps objects that
match at least one. With **All**, each card's value list is scoped to the enabled cards above it.
With **Any**, the cards are independent. Drag the grip, or use Alt+↑ / Alt+↓, to reorder.
Right-click a card for **Change property…**, **Collapse** or **Expand**, **Color by values** or
**Stop coloring**, **Disable filter** or **Enable filter**, **Move up**, **Move down**,
**Duplicate**, and **Remove filter**. A disabled card stays in the stack but does not hide
objects.
**Clear all filters** is in the panel header. **Reset filters** on the toolbar clears the same
stack without undoing hide and isolate.
Intelligence in this viewer can also color and isolate from Chat. That is documented on [Ask
questions about your models with Speckle Intelligence](/next/analytics/intelligence), not here.
## 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.
When nothing is saved and there are no groups, **Views** shows **No views yet**. A search with no
hits shows **No matching views**. An empty named group reads **Drop views here**.
Saving a view needs permission to create saved views on the project. Creating saved views needs
the Contributor project role or higher. Without that permission, **Save view** and **New group**
are disabled. **Sketch** is also disabled; its tooltip reads **You don't have write access**. See
[Saved views](/3d-viewer/saved-views) for grouping and sharing rules that have not changed.
On a self-hosted server, saved views are available only on Speckle Enterprise Server. For
deployment setup, see [Enterprise license — Saved
Views](/developers/server/deployment/enterprise-license#optional-saved-views).
Frame the camera, set filters and visibility, and add section planes or sketches you want
stored.
In **Views**, select **Save view**, or use the bookmark control on the toolbar. Name it. The new
view appears in the panel.
To keep a connector-published viewpoint as a saved view, select **Save as view** on that **Model
views** row, or drag the row into a saved-view group. Dragging into a group needs at least one
named group and permission to create views. You cannot drop a model view into **Ungrouped**.
**New group** creates an empty group as a drop target. Search with **Search views**. Cards show
the author and a relative date. Private views show a lock with the tooltip **Only visible to
you**.
On a saved view the ⋯ menu is **Rename**, **Make private** or **Make public**, and **Delete…**.
There is no **Set as home view**, **Replace view**, or **Copy link** on this menu. Use the eye
control to show or hide that view's sketches and measurements.
On a group the ⋯ menu is **Rename**, **Make all private** or **Make all public**, and **Delete
group…**. **Ungrouped** is a tail for views that were saved before grouping. You can drag views
out of it. You cannot drop views into it. Its menu is **Delete all views…**.
Deleting a view also deletes its sketches and measurements. The confirm dialog says so.
A view created in the previous viewer can show **Legacy view — not openable here yet**. Re-save
the look in this viewer if you need a viewpoint you can apply.
## 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.
Select **Section** on the toolbar. The tool options appear above the toolbar.
Select **Plane**, then click a surface, or select **XY**, **XZ**, or **YZ** to cut at the scene
centre. The model is clipped on one side of the plane.
Select a plane in the list to show its handle. Drag the handle, **Flip which side is cut away**,
or **Stop cutting** without removing the plane. **Resume cutting** turns that plane back on.
**Hide plane handles** keeps the cut for a cleaner screenshot. **Remove all planes** clears the
list. If **Plane** is disabled, the tooltip reads that all plane slots are in use.
### 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.
Measurements live on their saved views in the **Views** panel. Use the eye control on a view card
to show or hide that view's sketches and measurements. The same eye on a group header toggles
every view in that group.
### 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.
Sketches live on their saved views in the **Views** panel. Use the eye control on a view card to
show or hide that view's sketches and measurements. The same eye on a group header toggles every
view in that group.
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, visibility, and selection 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](/3d-viewer/issues).
To tie an issue to particular objects, select them in the scene before you select **New issue**.
The selection is stored with the issue, along with the camera, filters, and visibility at the
moment you select **Create issue**. Opening the issue selects those objects again. An issue
raised with nothing selected stores the view only.
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.
Issues are available when your workspace plan includes them. On a self-hosted server, they are
available only on Speckle Enterprise Server. For deployment setup, see [Enterprise license —
Issues](/developers/server/deployment/enterprise-license#optional-issues). Issue fields,
assignment, and permissions stay on [Issues](/3d-viewer/issues).
An issue created in the previous viewer may show **Legacy issue — its view can't be applied here
yet**. If the issue points at models that are not loaded, the tooltip reads **References models
not loaded in this scene — opens details only**.
## 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.
**Model placement** in this viewer is inspect-only. Switching placement is not enabled yet.
How Revit stores placement on publish is on [Revit in 2026.9](/next/connectors/revit/introduction).
Adding models to a scene from the project still follows [Model federation](/3d-viewer/federation).
## 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
Point clouds are not drawn in the 2026.9 viewer yet — see [Open a model](#open-a-model).
Re-publishing or re-uploading the model will not change what you see, and connectors that load
the point cloud keep working. Uploading an `.e57` file is a separate case — see [File uploads in
2026.9](/next/connectors/file-uploads).
Some colours and materials are not drawn in the 2026.9 viewer yet — see [Open a
model](#open-a-model). Your data is unchanged. If the model was published before your project
moved to the 2026.9 data format, publish it again from the source application to restore the
colours. For Grasshopper colours and Civil 3D surface materials, publishing again does not help
yet. There is no Shaded or Rendered view mode in this viewer, so switching modes is not a fix.
If the colour stands for a property such as status or category, use **Color by values** on that
property in **Filters** instead.
There is no dedicated diff view in the Models **⋯** menu. Speckle Intelligence covers change
detection, reporting, and impact assessment instead: ask Chat or the viewer sparkle to compare
two versions and summarise what was added, removed, or changed, save that as a shareable Report,
or turn a recurring comparison into a skill. See [Ask questions about your models with Speckle
Intelligence](/next/analytics/intelligence#what-you-can-ask), [Compare versions in a
Report](/next/analytics/reports#compare-versions), and [Assess model changes with Speckle
Intelligence](/next/workflows/assess-model-changes-with-intelligence) for a full worked example.
[Compare Versions](/3d-viewer/compare-versions) covers the deprecated Current-viewer flow.
The 2026.9 viewer cuts with section planes, not a box. Add **XY**, **XZ**, or **YZ**, or place a
plane on a surface, then flip or hide individual planes. Explode and the older view mode styles
are not on this toolbar. Projection and the grid are in **Settings**.
Sketch is stored on saved views, so it uses the same permission as **Save view**. Reviewers
without that permission cannot sketch. Save a view after you draw if you need the ink later.
On their saved view in the **Views** panel. Use the eye on the view card to show or hide that
view's sketches and measurements. A group header eye toggles every view in the group. See
[Sketch in 3D](#sketch-in-3d).
Yes, if they were stored on that view. Measurements live on that view in the **Views** panel
with sketches. Use the eye on the view card to show or hide them. A group header eye toggles
every view in the group. Without permission to save views, measurements last only for the
session. See [Measure](#measure).
Some older views show **Legacy view — not openable here yet**. Re-save the look in this viewer
if you need a viewpoint you can apply.
When no objects match, **Filters** shows **No objects match — everything is hidden**. Change the
values, switch **All** to **Any**, enable a disabled card, or use **Reset filters**.
No. **Color by values** is on string and relation cards only. Use Chat if you want Intelligence
to color by a property; that flow is on [Ask questions about your models with Speckle
Intelligence](/next/analytics/intelligence).
They are not on the 2026.9 view-card menu. You can **Rename**, change public or private, show or
hide ink, and **Delete**. Grouping and dragging still work. Home view and replace remain
documented for the viewer before 2026.9 on [Saved views](/3d-viewer/saved-views).
Not yet. **Model placement** lets you inspect the published datum. Changing placement on publish
is documented for Revit on [Revit in 2026.9](/next/connectors/revit/introduction).
No. Edits stay staged in **Elements** until you **Submit change requests**. That creates an
issue with the proposed values. The published version is unchanged.
Embeds do not show the model tree, **Filters**, selection details, or the toolbar in the 2026.9
viewer yet. Changing the embed options will not bring them back. Your model and its data are
unchanged. Open the model in the web app to filter, select, or measure.
Firefox on macOS supports WebGPU, but it currently allows only eight GPU storage buffer
bindings. That is the WebGPU specification minimum. The 2026.9 viewer needs nine, so the model
will not open. Other browsers on macOS allow ten or more, and Windows and Android browsers
generally allow sixteen or more. This is a known, accepted limitation, not a bug. Firefox may
raise the limit later; until then, use Chrome, Edge, or Safari.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.