Projects
Organising your data in Speckle
What are projects?
In Speckle, a project is where your data lives.
Think of a project as a container that helps you organise, manage, and share your work. You can give each project a name and description to help you keep things clear and easy to find.
Projects also let you collaborate with others. You can share a project with your team and control who can view or edit it.
What can a project contain?
A project can hold anything—from a few objects to an entire building model. You can create as many projects as you like and add as much (or as little) data as you need.
Some examples of what a project might include:
- A layer from a CAD application
- A furniture (Revit family)
- A workset or selection from Revit
- A group of objects from Grasshopper
- A structural model
- Calculation results
Projects are containers for models and versions, no project design data lives outside of a model version. We’ll explain how those work in the next sections. Only the name and description and the members of a project exist outside of a model version.
Who can I share projects with?
While a workspace can have members and guests that can impact who can have access to the projects within it, projects themselves can be shared with specific users to control access and within the security settings of the workspace.
Access Control
A project can have a global state of:
- Public: Anyone with the link can view,
- Workspace: All workspace members can view, but not guests, or
- Private: Only for project members and admins.
Discussions
The ability to contribute to discussions is controlled at the project level:
- Anyone: Anyone can contribute to discussions with comments and replies if they have access to the project and have a Speckle account.
- Collaborators: Only project collaborators can contribute to discussions.
Learn more about discussions in the discussions page.
Frequently Asked Questions
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.