Quick Reference
Frequently Asked Questions
We’ve collected commonly asked questions that you might have as you get started.
Projects, Models and Versions
Projects
Is there a limit to the number of projects I can create?
Is there a limit to the number of projects I can create?
The number of projects you can create is subject only to the limits of your workspace.
Can I delete a project?
Can I delete a project?
Yes, you can delete a project by selecting the project from the projects list
page and clicking the Delete project button.
Deleting a project is destructive. It will delete all the data associated with it.
Can I rename a project?
Can I rename a project?
Yes, if you the project owner, you can rename a project by selecting the
project from the projects list page and clicking the Rename project
button.
Can I move a project to another workspace?
Can I move a project to another workspace?
No, not in the web interface, if this is something you need critically,
contact us either in the application chat or by email at [email protected] A
project made in the personal projects era can be migrated one time to a
workspace.
If I rename a project will it break anything?
If I rename a project will it break anything?
No, it will not break anything. The only thing that will be affected is the
name of the project.
Can I enforce naming conventions to project names?
Can I enforce naming conventions to project names?
No, you cannot enforce naming conventions to project names.
Can I change the description of a project?
Can I change the description of a project?
Yes, you can change the description of a project by selecting the project from
the projects list page and clicking the Edit project button.
Is there a limit to the number of members in a project?
Is there a limit to the number of members in a project?
No, there is no limit to the number of members in a project. However, depending on your
workspace plan you may be charged for additional project members not already in your workspace.You can add as many viewers to your project as you like, they are free.
Models
Can I choose who can edit specific models?
Can I choose who can edit specific models?
No, edit rights are set at the project level only at this time.
Can I set a model as read-only?
Can I set a model as read-only?
No, read-only status is set at the project level only at this time.
Why use multiple models?
Why use multiple models?
Here are a few common reasons:
- Split by discipline: For large projects, separate models by team, e.g., Architecture, Structural, and MEP. This ensures each team receives only what’s relevant.
- Split by building: If your project includes multiple buildings, keep them in one project but create separate models like Building A, Building B, and Building C.
- Explore design options: Want to present different façade concepts? Create models like Option A, Option B, and Option C and switch between them to show your client.
What does 'federating models' mean?
What does 'federating models' mean?
In Speckle, you can federate models by loading multiple models into the same view — even if created separately.
This is useful for working with different teams or disciplines. For example, view the architecture, structure, and MEP models together in a single, coordinated view without merging them into one file.Federating models helps you:
- Compare design options
- Coordinate between disciplines
- Keep models separate while viewing them side by side You can do this directly in the Speckle 3D viewer or in supported design tools using our connectors.
How do I create and manage models?
How do I create and manage models?
You can create as many models as needed within a project. The Speckle Web App makes it simple to:
- Add new models
- Rename models
- Switch between models This helps you keep your work organised and ensures each model is used as intended.
How do I delete a model?
How do I delete a model?
You can delete a model by selecting the Delete model button in the model settings drop-down found on the models list page.
This will remove the model from the project and all associated data.
How many models can I have in a project?
How many models can I have in a project?
You can have as many models as you need in a project. However, the number of models you have in total in your workspace
across all projects may be limited by your workspace plan.
How do I switch between models?
How do I switch between models?
You can switch between models by selecting the model from the models list page.
This will open the model in the Speckle Web Viewer.
Can I rename a model?
Can I rename a model?
Yes, you can rename a model by selecting the model from the models list page and clicking the Rename model button.
How do I move a model to another folder?
How do I move a model to another folder?
You can move a model to another folder by selecting the model from the models list
page and clicking the Rename model button.
It is the presence of
/s in the model name that determines the folder structure.How many folders can I have?
How many folders can I have?
You can have as many folders as you need in a project. It is the presence of
/s in the
model name that determines the folder structure. However, it may be preferable to only use
one or two levels of folders to keep your models organised.Is there a maximum size for a model?
Is there a maximum size for a model?
Theoretically no, but the performance of the 3D viewer will be impacted if it is large number of
extremelly detailed objects. It can be benefical to break models up and federate them together
as required to keep the performance high.
Versions
Can I set an approval status on a version?
Can I set an approval status on a version?
You can only set the version message, potentially to something meaningful like “Approved for release”.
How long are versions stored for?
How long are versions stored for?
Versions are stored indefinitely, but you may be limited as to how many you can see depending on your workspace plan.
Can I prevent others from seeing specific versions?
Can I prevent others from seeing specific versions?
No, once a version is published it is visible to all users with permission to view the model.
Can I prevent others from deleting versions?
Can I prevent others from deleting versions?
Only the owner of the model can delete versions.
How many versions can I publish?
How many versions can I publish?
You can publish as many versions as you want, but you may be limited as to how many you can see.
I already published a version, can I still set or edit its version message?
I already published a version, can I still set or edit its version message?
Yes, you can set or edit the version message for any version from the version history page.
I can't see older versions
I can't see older versions
All older versions are stored indefinitely but may be hidden if depending on your workspace plan limits.
How do I visually compare versions?
How do I visually compare versions?
You can compare two versions to see the differences between them. This is useful to review changes,
or to see what changed between two specific points in time. You can do this in the 3D viewer, more details
can be found in the compare versions page.
How do I delete a version?
How do I delete a version?
If you’ve published a version by mistake you can delete it. This will remove it from the model
and if you delete the latest version it will make the previous version the latest.
How do I restore a version?
How do I restore a version?
You can’t promote a specific version to be the latest, but you can publish a new version
which will become the latest. Or delete all newer versions. Receiving a specific
version and re-publishing it will theoretically restore it, but this can be a lossy
process depending on the connector. More reliable would be to do so programmatically.
How do I set a version message?
How do I set a version message?
You will prompted in your connector to set a version message when you publish.
Permissions and Roles
Workspace roles
What is a workspace role?
What is a workspace role?
A workspace role is a role that determines what actions a user can perform within a workspace.
What are guest roles?
What are guest roles?
Guest roles are a type of workspace role that allows users to view and comment on models in a workspace.
How do I invite someone to my workspace?
How do I invite someone to my workspace?
You can invite someone to your workspace by clicking the Invite button in the top right corner of the workspace page.You can also set your workspace to allow self-signup by making your workspace domain discoverable.
Users with an email domain matching what you have verified to the workspace will be notified your
workspace exists and can request to join. You can also set it up to automatically add them to the workspace without admin approval.Learn more about inviting users to a workspace.
Only admins can invite users to a workspace.
How do I remove someone from my workspace?
How do I remove someone from my workspace?
You can remove someone from your workspace by clicking the Remove button in the top right corner of the workspace page.
Project roles
Can non-workspace members have a project role?
Can non-workspace members have a project role?
You can add anyone to a project role if it is allowable by the workspace security settings.
If a user is added to a project as member who can edit they will be added as an editor
to the workspace. If they are not a member of the workspace they will be added as a guest.
Can I assign roles to teams?
Can I assign roles to teams?
No, roles are set on a member by member basis.
Billing and Usage
Seats
Can I swap seats between people?
Can I swap seats between people?
Yes, within a billing cycle if a seat is removed from a workspace member or guest
then it can be allocated to another.
Allocating a seat to a new member or guest without first unallocating will
add a prorated cost for an additional seat for that billing cycle.
What happens if I remove an editor seat from a user who is a project collaborator?
What happens if I remove an editor seat from a user who is a project collaborator?
They will remain a project team member but their role will be downgraded to can view.
What happens if I remove an editor seat from a user who is a workspace member?
What happens if I remove an editor seat from a user who is a workspace member?
They will remain a workspace member but their role will be downgraded to can view. Their role
on any projects they are a member of will also be downgraded to can view.
Troubleshooting
Connectors
Specific connector frequently asked questions can be found in each connector’s usage guide.Revit
Usage guide for publishing and loading Revit models.
Rhino
Usage guide for publishing and loading Rhino models.
Grasshopper
Usage guide for publishing and loading Grasshopper models.
Power BI
Usage guide for loading models into Power BI.
Blender
Usage guide for loading models into Blender.
Civil 3D
Usage guide for publishing and loading Civil 3D models.
AutoCAD
Usage guide for publishing and loading AutoCAD models.
Archicad
Usage guide for publishing and loading Archicad models.
Tekla
Usage guide for publishing Tekla models.
ETABS
Usage guide for publishing ETABS models.
Navisworks
Usage guide for publishing Navisworks models.
SketchUp
Usage guide for publishing and loading SketchUp models.
General Connector Troubleshooting
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 is one of the supported versions. Installation issues are also sometimes caused by conflicting plugins. Please report your problem in our Community Forum: https://speckle.community/c/helpAnd include the following information:
- Your application version
- Your Speckle connector version
Why did I get an error when using the Speckle command to open the connector?
Why did I get an error when using the Speckle command to open the connector?
If you still have the legacy version installed, make sure you have
version 2.23 or above. Any version below 2.23 will have conflicting commands with the AutoCAD connector.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: https://speckle.community/c/helpWhy are some objects that I published or loaded missing from my model?
Why are some objects that I published or loaded missing from my model?
After you publish or 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 publishing or loading.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?
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: https://speckle.community/c/help And include the following information:- Your application version
- Your Speckle connector version
- A copy of the log
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, you should also remove Speckle Desktop Services as well as your Speckle connector.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 at https://app.speckle.systems/connectors. If a new version of the connector is available, you will also see a notification in your connector UI. [@bilal need autoupdating behavior]
Where do I download Speckle Manager?
Where do I download Speckle Manager?
Speckle Manager has been deprecated and is no longer required to install connectors. It can still be downloaded and used with legacy connectors.
How do I install connectors for Mac?
How do I install connectors for Mac?
Connectors are currently available for Windows only.
I need more help!
I need more help!
You can always reach us by posting on our Community Forum: https://speckle.community. We try our best to respond as quickly as possible!
How to Get Help
If you have any questions or issues not listed here, please contact us:- In-app support
- Community support
- Report a bug
- Request a feature
- Ask a question
- Business plan support
- Some plans include priority support.