> ## Documentation Index
> Fetch the complete documentation index at: https://speckle-assistant.mintlify.site/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 and clicking the **Delete project** button.

    <Warning>
      Deleting a project is destructive. It will delete all the data associated with it.
    </Warning>
  </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 are guest roles?">
    Guest roles are a type of workspace role that allows users to view and comment on models in a workspace.
  </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?">
    You can remove someone from your workspace by clicking the **Remove** button in the top right corner of the workspace page.
  </Accordion>
</AccordionGroup>

### Project roles

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

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

## Billing and Usage

### Seats

<AccordionGroup>
  <Accordion title="How can I upgrade from a free plan?">
    New plans are coming in the new year. Contact us to purchase Speckle today.

    Contact us at [hello@speckle.systems](mailto:hello@speckle.systems) for more information.
  </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/tekla/">
    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
* Business plan support
  * Some plans include priority support.