> ## 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.

# Models

> Organising your data in Speckle

**Models** help you organise your data within a project. They're useful for splitting
different parts of your work, such as design options, disciplines, or team responsibilities.
A model can be a direct relationship to a 3d model file, or a portion of it, or it can relate
to multiple files within a single model. Models work best when they are used to represent a
particular part of your work, a focus for a conversation, a single package deliverable
or a particular discipline, the choice is yours.

## Creating Models

A new project starts without models present. You can create an empty model in the web interface or
from a connector. This is simply a container for your data; it will have data in it
once you publish data from a supported design tool using a connector.

You can keep everything in that model or create additional ones to explore design options,
separate work by team or discipline, and organise project components more clearly.

Models give you the flexibility to structure your data to fit how you work.

<Frame>
  <img src="https://mintcdn.com/speckle-assistant/2EmalpcbVGQpx8bs/images/workspaces/mode-folder-structure.jpg?fit=max&auto=format&n=2EmalpcbVGQpx8bs&q=85&s=7a3c310929ce34a74483d833724dd3db" width="1620" height="1080" data-path="images/workspaces/mode-folder-structure.jpg" />
</Frame>

## Managing Models

You can create as many models as you need within a project within your workspace limits.
The Speckle Web App makes it simple to add new models and switch between them.

Models can be named to mimic a folder structure by using a forward slash `/` in the name,
e.g. `Building A/Floors/Floor 1`.

<Frame>
  <img src="https://mintcdn.com/speckle-assistant/2EmalpcbVGQpx8bs/images/workspaces/mode-folder-create.jpg?fit=max&auto=format&n=2EmalpcbVGQpx8bs&q=85&s=234d89887807a30589c5ac029d436128" width="1620" height="1080" data-path="images/workspaces/mode-folder-create.jpg" />
</Frame>

## Frequently Asked Questions

<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>