Skip to main content
To publish and load Speckle models in Grasshopper, you need:
  • A Speckle account signed in on your computer.
  • A link to the specific Speckle model.
Not sure what Speckle workspaces, projects, models, and versions are? Brush up on Speckle basics here.

​
Signing in to your Speckle account

If you don’t already have a Speckle account signed in on your computer, use the Sign-In node and follow the steps in your browser to add your Speckle account.
Node signin
Inputs:
  1. By default, this node will sign in to app.speckle.systems. Add a Server URL input only if you want to sign in to a custom server.
  2. Click the Sign In button to start the sign in process in your web browser. Follow the prompts in your web browser to complete sign in.
Outputs:
  1. The Accounts output contains a list of all accounts you are signed into on your local computer.
You only need to sign in to your account once to use the Grasshopper connector. That sign-in also works with other Speckle connectors on your computer.
Accounts are stored locally on your computer and shared by every Speckle connector installed on it. Add an account with the Sign-In node; remove it from the account menu of any other Speckle connector. Once an account is removed, sign in again with the Sign-In node.
Grasshopper connector versions before 2026.9.1 sign in through Speckle Desktop Services, which is deprecated. Update the connector, or sign in from another Speckle connector on the same computer.

​
Linking to a Speckle model

All Speckle model management, including creating or deleting workspaces, projects, and models, should be done in your web browser when using the Speckle Grasshopper connector.
Use the Speckle Model node to create a model resource for the specific Speckle model you want to publish to or load from in the web.
Node model
If you are getting errors retrieving your model, make sure you have the correct Speckle account selected in your Speckle Model node. To check or change your account, right-click > select Account on the node.
Option 1: Creating a link using the node buttons: You can use the buttons on the Speckle Model node to explore and select your available Speckle models. The buttons correspond to your available Workspaces, Projects, Models, and Versions (in that order).
  1. By default, the first button will display your first available Workspace. To change your Workspace, left-click the first button and select the correct one.
  2. Left-click the second button to select your Speckle Project in the Workspace.
  3. Left-click the third button to select your Speckle Model in the Project.
  4. By default, the last button will display the latest version of your selected Model. There is no need to change this, unless you would like to load a specific earlier version of your Model.
You can always view your Speckle Model resource in your web browser by right-click > select View in Browser on the Speckle Model node.
Option 2: Creating a link using an input URL: You can use the URL address of a Speckle Model, copied from a web browser, to automatically populate the Workspace, Project, Model, and Version of the Speckle Model node.
  1. Open your Speckle Model in your web browser.
  2. Copy the URL of your model. The URL should have the following format: https://app.speckle.systems/projects/[project id]/models/[model id].
  3. Paste your URL to a Panel in your Grasshopper document and add it to the URL input of the Speckle Model node. You should now see all node buttons correctly set.

​
Loading models

Use the Load node to load a Speckle Model into your Grasshopper document.
Node load
Inputs:
  1. Add a Speckle Model input of the Speckle Model you want to load.
  2. Click the Load button to load your model.
Outputs:
  1. The Collection output contains your loaded model.
Additional Settings: Right-click the node for additional settings:
  • Set your node to load automatically whenever there is a new version of your Speckle model. Make sure your input Speckle Model node does not have a specific version set to enable this setting.
  • View your model online in your web browser.

​
Publishing models

Use the Publish node to publish your Grasshopper model to Speckle.
Node publish
Inputs:
  1. Add a Speckle Model input of the Speckle Model you want to publish a new version to.
  2. Add a Collection input containing the Collection of objects you want to publish.
  3. Add an optional Version Message input to describe the version of the model you are about to publish.
  4. Click the Publish button to publish your model.
Outputs:
  1. The Speckle Model output contains the Model you just published.
Additional Settings: Right-click the node for additional settings:
  • Set your node to publish automatically whenever there is a new solve of the Collection you are publishing.
  • View your model online in your web browser.
Last modified on October 8, 2026