Speckle currently supports SketchUp versions: 2021, 2022, 2023, 2024, 2025 & 2026. SketchUp
connector works on Windows & macOS.
Installing on macOS
Mac users: see our manual installation guide for zip-based installation instructions
Setup
1
Install the connector
Install your SketchUp connector
2
Open the SketchUp connector
- Navigate to Extensions > Speckle.
- Select Initialize Speckle to open the SketchUp connector.
- Select Sign in if you haven’t linked your Speckle account.
Why is the Speckle plugin not showing up after I installed the connector?
Why is the Speckle plugin not showing up after I installed the connector?
- Make sure your version of SketchUp is one of the supported versions.
- Uninstall and reinstall your connector.
Don’t select Run as administrator when installing: that installs the connector for the
administrator account, not yours. Double-click the
.exe, or right-click it and select Open.- Your application version
- Your Speckle connector version
What should I do if the plugin UI is empty or unresponsive, or if my application crashes?
What should I do if the plugin UI is empty or unresponsive, or if my application crashes?
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. Report your problem in our Community
Forum and include your application version, your Speckle
connector version, and a copy of the log.Why can't I add a new account?
Why can't I add a new account?
Signing in opens a browser page for your Speckle server. If it doesn’t open, or it never returns
you to the connector, check that you can reach your server in your browser, update the connector
to the latest version, and try again.
My connector asks for Speckle Desktop Services. What do I do?
My connector asks for Speckle Desktop Services. What do I do?
Older connector versions sign in through Speckle Desktop Services, which is deprecated. Update the
connector to the latest version. If you must stay on the older version, search for Speckle
Desktop Services in Windows search and run it before signing in.
How do I uninstall my connector?
How do I uninstall my connector?
All Speckle connectors are installed like any other program. You can uninstall them directly from
your system’s
Applications. For a full uninstall, also remove Speckle Desktop Services if it
is installed.How do I update my connector to the latest version?
How do I update my connector to the latest version?
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 select New Project to create one
3
Choose a model
- Select an existing model - or select New Model to create one
4
Select objects to publish
- In your application viewport, select the elements you want to publish.
- Select Publish.
- Your model is now published to Speckle and is available to the rest of your team.
What types of SketchUp elements can I publish to Speckle?
What types of SketchUp elements can I publish to Speckle?
You can publish all types of
components, groups, faces, and lines to Speckle. Each published object includes:- Custom user attributes
- Render materials
How do I see custom user attributes on my published SketchUp objects?
How do I see custom user attributes on my published SketchUp objects?
Select an object in your browser and look under the properties field to view all user attributes.
Why aren't my SketchUp materials applied correctly when loaded in other applications?
Why aren't my SketchUp materials applied correctly when loaded in other applications?
This usually happens when you apply materials to components instead of their faces. Apply materials to faces for correct display in other applications.
Why does my model have the wrong colors in the web browser viewer?
Why does my model have the wrong colors in the web browser viewer?
In the viewer, select the View Modes button in the side bar, and switch the view mode to
Shaded. If you still don’t see your object colors, let us know in our Community
Forum
Are bitmap or image-based material textures supported?
Are bitmap or image-based material textures supported?
Image texture files are not supported. Speckle does not transfer bitmaps or other image maps (such as JPG or PNG files) embedded in materials from the source application.Speckle does carry PBR-style material data in general—where a connector maps to it, materials can include properties such as base colour, opacity, metalness, roughness, and emissive colour. That is not the same as shipping texture images: you get numeric material parameters, not image assets used for wood grain, brick patterns, and similar in the authoring tool.Different materials can still appear separately in the destination with distinct colours and PBR fields. What you see may look closer to a consistent shaded or PBR preview than to the full render-appearance with image maps in tools such as Revit or SketchUp. To use image textures in your target application, apply or remap them locally after you publish or load.
Why are some objects that I published missing from my model?
Why are some objects that I published missing from my model?
After you publish 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 publishing.
Loading a Model
1
Select Load
2
Choose a project
3
Choose a model
4
Choose a version to load
- Latest version is always first.
- To load a specific version, select it from the UI.
How are Speckle models loaded in SketchUp?
How are Speckle models loaded in SketchUp?
All objects in Speckle models are loaded as Components in SketchUp. They’re created with the same layers you see when viewing your model in the browser.
- Name of the object is loaded as component name
- Render materials are applied.
- Properties are loaded as user attributes.
Are properties from other applications, like Revit parameters, loaded in SketchUp?
Are properties from other applications, like Revit parameters, loaded in SketchUp?
Yes, all parameters found under the properties field are loaded as user attributes in SketchUp.
How do I see the user attributes on my loaded SketchUp objects?
How do I see the user attributes on my loaded SketchUp objects?
To view them, you can use Attribute Helper plugin from SketchUp.
Why are some objects that I loaded missing from my model?
Why are some objects that I loaded missing from my model?
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 SketchUp.
Are bitmap or image-based material textures supported?
Are bitmap or image-based material textures supported?
Image texture files are not supported. Speckle does not transfer bitmaps or other image maps (such as JPG or PNG files) embedded in materials from the source application.Speckle does carry PBR-style material data in general—where a connector maps to it, materials can include properties such as base colour, opacity, metalness, roughness, and emissive colour. That is not the same as shipping texture images: you get numeric material parameters, not image assets used for wood grain, brick patterns, and similar in the authoring tool.Different materials can still appear separately in the destination with distinct colours and PBR fields. What you see may look closer to a consistent shaded or PBR preview than to the full render-appearance with image maps in tools such as Revit or SketchUp. To use image textures in your target application, apply or remap them locally after you publish or load.
Why can't I select a project in the UI—it's disabled?
Why can't I select a project in the UI—it's disabled?
This happens when you don’t have permissions to load a project. Contact the project owner to
change your role.
Can I load a model via URL?
Can I load a model via URL?
Yes. Next to the search box in the project selection dialog, there’s an Add model by URL
option. Paste the model URL there.