Skip to main content
Speckle currently supports versions: . The connector works on only.

​
Setup

1

Install the connector

Install your connector
2

Open the Blender connector

  1. Press N from your keyboard to open the side toolbar.
Blender toolbar
  1. Select Speckle to open the Blender connector.
Make sure you activated the Speckle connector:
  1. Go to Edit > Preferences > Add-ons
  2. Search for Speckle
  3. Select Install
  1. Make sure your version of is one of the supported versions.
  2. Uninstall and reinstall your connector.
Note: Make sure you are not selecting Run as administrator when installing - this will install for the administrator user, and not your own user. Instead, double-click the .exe or right-clicking and then selecting Open to run the installer. Installation issues can also be caused by conflicting plugins.If you’re still experiencing problems, please report it in our Community Forum and include the following information:
  • Your application version
  • Your Speckle connector version
If your connector window is floating, try docking it to your application to fix blank UI issues.For major issues, you can sometimes find a log file in your directory at AppData\Roaming\Speckle\Logs. Please report your problem in our Community Forum and include the following information:
  • Your application version
  • Your Speckle connector version
  • A copy of the log
This can happen if our desktop service isn’t running. Desktop Service is used for authenticating new accounts. If it’s not running, search for Speckle Desktop Services in Windows search and run it.
All Speckle connectors are installed like any other program. You can uninstall them directly from your system’s Applications. For a full uninstall, you should also remove Speckle Desktop Services as well as your Speckle connector.
You can always download the latest version of the connector in the web app. If a new version of the connector is available, you will also see a notification in your connector UI.

​
Publishing a Model

1

Select Publish

2

Choose a project

  • Select an existing project
  • or click the + button and select Create Project to create a new project
3

Choose a model

  • Select an existing model
  • or click the + button and select Create Model to create a new model
4

Select objects to publish

  1. In your application viewport, select the elements you want to publish.
  2. Select Publish.
  3. Your model is now published to Speckle and is available to the rest of your team.
All types of Mesh, Bezier, Circle, NURBS Curve and NURBS Circle are supported.
Camera and Lights are not supported.
You can enable a publish setting to publish modifiers:
  1. Open the Publish to Speckle window
  2. Make sure that Apply Modifiers is checked
  3. Click OK to publish with all object modifiers.
Blender connector only supports the following shaders:
  • Principled
  • Diffuse
  • Emission
  • Glass
Blender will fallback to material properties if an unsupported shader is selected.
Speckle currently does not support textures.

​
Loading a Model

1

Select Load

2

Choose a project

3

Choose a model

4

Choose a version to load

  • Latest version is loaded by default.
  • To load a specific version, select it from the UI. Your selected model is now loaded in Blender.
You can modify materials and it will be preserved when you load a new version.
Currently, properties are not loaded and attached to loaded objects.
By default, blocks are loaded as collection instances. To load blocks as linked duplicates:
  1. Open the Load model window
  2. Set the Instance Loading option to Linked Duplicates
  3. Click OK to load models with blocks as linked dupicates Loading blocks as linked duplicates is more efficient for blocks with many instances.
After you load a Speckle model, click on the Report button to see any errors that may have occurred. Click on any item in the report to highlight that item in your application. Some objects may not be supported for loading in .
This happens when you don’t have permissions to load a project. Contact the project owner to change your role.
Yes. Next to the search box in the project selection dialog, there’s an Add model by URL option. Paste the model URL there.
⌘I