Skip to main content

​
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:
  • Workspace: All workspace members can view, but not guests,
  • Private: Only for project members and admins, or
  • Public: Anyone with the link can view and download all project data via the web interface or API.

​
How to Change Project Visibility

To change your project’s visibility setting:
  1. Open your project in the Speckle web application
  2. Navigate to Project settings (accessible from the project page)
  3. Find the Visibility or Access Control section
  4. Select your desired visibility level:
    • Workspace: Restricts access to workspace members only
    • Private: Limits access to project members and workspace admins
    • Public: Makes the project accessible to anyone with the link
  5. Save your changes
When you make a project Public, anyone with the project link can view and download all project data, including accessing it programmatically via the Speckle API, SDKs (such as specklepy), or connectors (like Rhino/Grasshopper). This means all model data, properties, and metadata are accessible without any authentication. All models in the project will inherit the project’s visibility setting.If you need to share only 3D visualization data while protecting underlying model information, consider creating a separate project with only display geometry (stripped of properties and metadata) before making it public.

​
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

The number of projects you can create is subject only to the limits of your workspace.
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.
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.
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.
Important: All personal projects will be permanently deleted on January 1, 2026. If you have personal projects, migrate them to a workspace before this deadline.
No, it will not break anything. The only thing that will be affected is the name of the project.
No, you cannot enforce naming conventions to project names.
Yes, you can change the description of a project by selecting the project from the projects list page and clicking the Edit project button.
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.
To make a project public, you need to change its visibility settings. Visibility is controlled at the project level, which means all models within the project will inherit the same visibility setting.To make your project public:
  1. Navigate to your project in the Speckle web application
  2. Open the project settings (usually accessible via a settings icon or gear menu)
  3. Find the Visibility or Access Control section
  4. Change the visibility setting from Private or Workspace to Public
  5. Save your changes
Once set to Public, anyone with the project link will be able to view and download all project data, even without a Speckle account. This includes:
  • Viewing the project in the web interface
  • Accessing all model data via the Speckle API
  • Downloading data using SDKs (like specklepy) or connectors (like Rhino/Grasshopper)
  • Retrieving all properties, metadata, and geometry
Important: Public projects are truly public data. Anyone with the link can programmatically download and retrieve all model data, properties, and metadata without authentication. This is by design and cannot be restricted. If you need to share only 3D visualization while protecting underlying data, consider creating a separate project with only display geometry (stripped of properties and metadata) before making it public.
Yes. Public projects are accessible without authentication, which means anyone with the project link can:
  • View the project in the web interface
  • Download all model data using the Speckle API
  • Access data programmatically using SDKs (Python, .NET, TypeScript) or connectors (Rhino, Grasshopper, Revit, etc.)
  • Retrieve all properties, metadata, and geometry information
This is by design—public projects are truly public data. There is no way to restrict programmatic access while keeping a project public. The Speckle API and all connectors can access public project data without requiring authentication tokens.If you need to share 3D visualization on a website while protecting your underlying model data, consider:
  • Creating a separate project containing only display geometry (stripped of properties and metadata)
  • Using a Private project with specific collaborators instead of making it public
  • Embedding a private project with token-based access, though note that embed tokens can still be used to access project data via the API
If you embed a public Speckle model on a website, anyone can extract the project URL and download the complete model data using Speckle tools or the API. Make sure you’re comfortable with all project data being publicly accessible before making a project public.