> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt
> Use this file to discover all available pages before exploring further.

# Frequently Asked Questions

> We've collected commonly asked questions that you might have as you get started.

export const app_0 = undefined

## Projects, Models and Versions

### Projects

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="Can I delete a project?">
    Yes, you can delete a project by selecting the project from the projects list
    page, **Settings** and at the foot of the **General Settings**, and clicking the **Delete project** button.

    On the Enterprise plan, you can archive inactive work instead of deleting it.
    See [Archive and unarchive projects](/workspaces/archived-projects).

    <Warning>
      Deleting a project is destructive. It will delete all the data associated with it.
    </Warning>
  </Accordion>

  <Accordion title="Can I archive a project instead of deleting it?">
    Yes, on the Enterprise plan. Archiving removes the project from active lists
    without deleting its models and versions, and you can restore it later when
    needed. See [Archive and unarchive
    projects](/workspaces/archived-projects).
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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 [support@speckle.com](mailto:support@speckle.com) A
    project made in the personal projects era can be migrated one time to a
    workspace.

    <Warning>
      **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.
    </Warning>
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Can I enforce naming conventions to project names?">
    No, you cannot enforce naming conventions to project names.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="How do I make my project (or model) public?">
    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

    <Warning>
      **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.
    </Warning>
  </Accordion>

  <Accordion title="Can public projects be downloaded or accessed programmatically?">
    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

    <Warning>
      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.
    </Warning>
  </Accordion>
</AccordionGroup>

### Models

<AccordionGroup>
  <Accordion title="Can I choose who can edit specific models?">
    No, edit rights are set at the project level only at this time.
  </Accordion>

  <Accordion title="Can I set a model as read-only?">
    No, read-only status is set at the project level only at this time.
  </Accordion>

  <Accordion title="Why use multiple models?">
    Here are a few common reasons:

    * **Split by discipline**: For large projects, separate models by team, e.g., <em>Architecture</em>, <em>Structural</em>, and <em>MEP</em>. 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 <em>Building A</em>, <em>Building B</em>, and <em>Building C</em>.
    * **Explore design options**: Want to present different façade concepts? Create models like <em>Option A</em>, <em>Option B</em>, and <em>Option C</em> and switch between them to show your client.
  </Accordion>

  <Accordion title="What does 'federating models' mean?">
    In Speckle, you can <strong>federate models</strong> 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 <em>architecture</em>, <em>structure</em>, and <em>MEP</em> 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 <strong>Speckle 3D viewer</strong> or in supported
      design tools using our **connectors**.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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**.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

### Versions

<AccordionGroup>
  <Accordion title="Can I set an approval status on a version?">
    You can only set the version message, potentially to something meaningful like "Approved for release".
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Can I prevent others from deleting versions?">
    Only the owner of the model can delete versions.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="I can't see older versions">
    All older versions are stored indefinitely but may be hidden if depending on your workspace plan limits.
  </Accordion>

  <Accordion title="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](/3d-viewer/compare-versions) page.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="How do I set a version message?">
    You will prompted in your connector to set a version message when you publish.
  </Accordion>
</AccordionGroup>

## Permissions and Roles

### Workspace roles

<AccordionGroup>
  <Accordion title="What is a workspace role?">
    A workspace role is a role that determines what actions a user can perform within a workspace.
  </Accordion>

  <Accordion title="What's the difference between Members and Guests?">
    **Members** are workspace users who are part of your core team. They can access all workspace projects by default (unless a project is set to Private), can create new projects, and are subject to workspace security policies like domain protection and SSO.

    **Guests** are external collaborators who only need access to specific projects. They can only access projects they're explicitly invited to, cannot create new projects, and can join the workspace without adhering to domain policies or SSO requirements. This makes Guests ideal for subcontractors, consultants, or clients who need limited access.

    Both Members and Guests count toward your workspace's user limit. The distinction is about access scope and security policies, not billing.
  </Accordion>

  <Accordion title="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.

    <Note>
      Only admins can invite users to a workspace.
    </Note>

    Learn more about [inviting users to a workspace](/workspaces/inviting).
  </Accordion>

  <Accordion title="How do I remove someone from my workspace?">
    Admins can remove users from the workspace from Workspace Settings -> People. Removing a user from the workspace also removes their access to all projects in that workspace, whether they were a Member or Guest.
  </Accordion>

  <Accordion title="Do Guests count toward my user limit?">
    Yes, both Members and Guests count toward your workspace's user limit. The limit applies to the total number of users who have access to your workspace, regardless of whether they're internal team members (Members) or external collaborators (Guests). If you need more users than your plan allows, contact us to discuss upgrading to Enterprise, which supports unlimited users.
  </Accordion>

  <Accordion title="When should I use Guest instead of Member?">
    Use the Guest role when you need to give someone access to only specific projects, such as:

    * External consultants or subcontractors who only work on certain projects
    * Clients who need to review specific work
    * Partners who collaborate on select projects

    Use the Member role for your core team who need access to multiple or all workspace projects and should be subject to your workspace's security policies.
  </Accordion>

  <Accordion title="How can I open or access my Speckle account from a previous company I left?">
    You can only log in if you still have access to an email address that is on that account (e.g. a work or educational address). If you have both a personal and a work email on the account, you may still get in with the one you still use. Access to data in a workspace is always in accordance with the permissions set by the workspace organisation (e.g. whether they have kept you as a member). If you no longer have any of those emails, you cannot log in or recover that account; create a new account with a current, supported email. Workspaces belong to the organisation; if you need access to data and no longer have it, contact your prior employer.
  </Accordion>
</AccordionGroup>

### Project roles

<AccordionGroup>
  <Accordion title="Can non-workspace members have a project role?">
    You can add anyone to a project role if this is allowed by workspace
    security settings. If a user is added to a project with the
    **Contributor** role, they are granted contributor-level project permissions.
    If they are not already a workspace member, they are added as a Guest.
  </Accordion>

  <Accordion title="Can I assign roles to teams?">
    No, roles are set on a member by member basis.
  </Accordion>
</AccordionGroup>

## Billing and Usage

### Users and Plans

<AccordionGroup>
  <Accordion title="How can I upgrade from a free plan?">
    You can upgrade your workspace to a paid plan from Settings -> Billing.
    Contact us at [hello@speckle.systems](mailto:hello@speckle.systems) if you need help choosing the right plan for your needs.
  </Accordion>

  <Accordion title="What happens if I change a user's project role?">
    Workspace admins and project owners can change project roles. Changing a
    user from **Contributor** to **Reviewer** removes publish/load capability,
    but the user remains in the project and workspace. This does not affect
    billing. Plans are based on total users, not project role.
  </Accordion>

  <Accordion title="Can I remove users from my workspace?">
    Yes, workspace admins can remove users from Settings -> People. Removing a user does not
    immediately free up a user slot if you're at your plan's limit—the user count adjusts when
    you add new users or upgrade your plan.
  </Accordion>
</AccordionGroup>

## Troubleshooting

### Connectors

Specific connector frequently asked questions can be found in each connector's usage guide.

<Columns cols={4}>
  <Card title="Revit" href="/connectors/revit/">
    Usage guide for publishing and loading Revit models.
  </Card>

  <Card title="Rhino" href="/connectors/rhino/">
    Usage guide for publishing and loading Rhino models.
  </Card>

  <Card title="Grasshopper" href="/connectors/grasshopper/">
    Usage guide for publishing and loading Grasshopper models.
  </Card>

  <Card title="Power BI" href="/connectors/power-bi/">
    Usage guide for loading models into Power BI.
  </Card>

  <Card title="Blender" href="/connectors/blender/">
    Usage guide for loading models into Blender.
  </Card>

  <Card title="Civil 3D" href="/connectors/civil3d/">
    Usage guide for publishing and loading Civil 3D models.
  </Card>

  <Card title="AutoCAD" href="/connectors/autocad/">
    Usage guide for publishing and loading AutoCAD models.
  </Card>

  <Card title="Archicad" href="/connectors/archicad/">
    Usage guide for publishing and loading Archicad models.
  </Card>

  <Card title="Tekla" href="/connectors/teklastructures/">
    Usage guide for publishing Tekla models.
  </Card>

  <Card title="ETABS" href="/connectors/etabs/">
    Usage guide for publishing ETABS models.
  </Card>

  <Card title="Navisworks" href="/connectors/navisworks/">
    Usage guide for publishing Navisworks models.
  </Card>

  <Card title="SketchUp" href="/connectors/sketchup/">
    Usage guide for publishing and loading SketchUp models.
  </Card>
</Columns>

#### General Connector Troubleshooting

<AccordionGroup>
  <Accordion title="Why is the Speckle plugin not showing up after I installed the connector?">
    Make sure your version of {app_0} 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/help](https://speckle.community/c/help)

    And include the following information:

    * Your application version
    * Your Speckle connector version
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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/help](https://speckle.community/c/help)
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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](https://speckle.community/c/help) And include the following information:

    * Your application version
    * Your Speckle connector version
    * A copy of the log
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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](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]
  </Accordion>

  <Accordion title="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](https://releases.speckle.systems/legacy-connectors).
  </Accordion>

  <Accordion title="How do I install connectors for Mac?">
    Connectors are currently available for Windows only.
  </Accordion>

  <Accordion title="I need more help!">
    You can always reach us by posting on our Community Forum: [https://speckle.community](https://speckle.community/). We try our best to respond as quickly as possible!
  </Accordion>
</AccordionGroup>

## 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
* Paid plan support
  * Paid plans include priority support.