Upgrade Grasshopper to 2026.9

This is 2026.9 preview documentation. Coverage here is incremental: a page exists only where 2026.9 differs or is newly documented.

Existing scripts keep working. Nothing on your canvas is deleted. This page is the mechanical path onto the current Load and Publish nodes. For publish and load today, see How to use Speckle for Grasshopper. For node names, Explore, and extra objects, see Grasshopper in 2026.9.

Nothing is removed from your canvas and no wires break. The nodes you already have are renamed and hidden from the ribbon, not deleted.

When to switch

If you…	Then…
Have scripts that work and you are not changing them	Nothing to do. Leave them alone.
Are building a new script	Use the current nodes. The ribbon only offers those.
Want the Explore node	Upgrade the script’s Load node.
Load a version published by an upgraded teammate	Upgrade the script’s Load node.

Before and after

On your canvas	After you switch
Load / Publish	Current nodes. They support 2026.9 onwards.
Load (legacy) / Publish (legacy)	Your existing nodes, renamed. They still work, and they are hidden from the ribbon.
Speckle Data Object	Renamed Speckle Object. Same node, same ports.
Speckle Geometry (legacy)	Your existing Speckle Geometry node. It still works, and it is hidden.
Speckle Geometry	New. Geometry, colour, and material — no Name or Properties.

The same rename applies to (Sync) Load and (Sync) Publish.

Output	Load (legacy)	Load
Collection	Data Objects and geometry	Speckle Objects and geometry
Properties	Model-wide properties	Model-wide properties
Proxies	Materials, colours, levels, groups	Not available

How to switch

Add the current Load node

Place a Load node from the ribbon and move your Speckle Model wire onto it. You should see the same Collection output as before.

Reconnect anything downstream

Check that nodes reading that Collection still resolve. Objects come through as Speckle Objects rather than Data Objects — the same shape under a new name — so most wires carry straight over.

Delete the old node

Remove the Load (legacy) node once nothing is wired to it. The definition should now load through the current node only.

Repeat for Publish, if your script publishes

Confirm collaborators have upgraded first. Switching Publish affects people who load your model, not just you. If you are not sure, leave Publish on the legacy node and upgrade Load only.

If your script publishes and then reloads in the same definition, use the current nodes for both. A version created by the current Publish node cannot be read by a Load (legacy) node.

Messages you might see

Message	What it means
This Load component is deprecated	You are on a legacy node. Nothing is wrong. Upgrade when convenient.
This version was published before Speckle 2026.9.0	An older version loaded. Grouping and collection paths may differ.
This version needs the current Load component	A legacy node hit a version it cannot fully read. Upgrade the node.
Versions published by this component can be read by older connectors	A reminder from Publish (legacy). Check collaborators before switching.
The name or properties on the incoming geometry were replaced	The Speckle Object’s name and properties win. Set them on the object.
Replacing the geometry dropped its properties	Swapping a shape does not carry properties across. Use a Speckle Object.

FAQ

Will my saved scripts break?

No. Nodes are matched by identity, not by name, so renaming them has no effect on your files. No node turns into a placeholder and no wire is dropped.

Why can't I find Load in the ribbon anymore?

You can — it is in the same place it always was. The node named Load (legacy) is the hidden one, and the Load in the ribbon is the current node.

Can I copy a legacy node from an old script?

Yes. Copy and paste still works. Replace it with the current node so the script does not carry the older behaviour forward.

Do I have to upgrade Load and Publish together?

No. They are independent. Upgrading Load only is a good first step, because it affects nobody but you.

Quick Reference

Your Speckle Workspace

Viewing & Sharing

Publishing & Loading

Analytics & Intelligence

Workflows

Upgrade Grasshopper to 2026.9

When to switch

Before and after

How to switch

Messages you might see

FAQ

​When to switch

​Before and after

​How to switch

​Messages you might see

​FAQ

When to switch

Before and after

How to switch

Messages you might see

FAQ