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

# Direct uploads

> Upload files directly to your Speckle projects and view them in your browser—no desktop software or connector needed.

## When to use file uploads

Upload files directly when you:

* Need to convert IFC data to Speckle format
* Don't have the source application or license
* Want to view a model quickly in your browser
* Receive files from collaborators who don't use Speckle connectors
* Work with file formats that don't have a dedicated Speckle connector

## Uploads and connectors produce different datasets

<Warning>
  A file uploaded directly and the same file published through its desktop connector do **not**
  produce identical Speckle data. Object structure, property coverage, and coordinate handling
  differ by format and by route.
</Warning>

This matters beyond visual fidelity. [Intelligence dashboards](/analytics/intelligence-dashboards), [Data Validation](/analytics/data-validation/overview), Power BI and any querying you build on model data all read the published objects and their properties. If some models in a project arrive by upload and others by connector, those tools are comparing unlike data — counts, groupings and validation results can differ for what is nominally the same source file.

Choose one route per project and stay with it, and be explicit about which route produced any figures you report.

The two routes serve different purposes. Uploads read a file, so they cover formats and situations where no connector exists or the authoring application is not available. Connectors run inside the authoring application, so they can carry data that lives in the session rather than the file — selection and view filters, coordinate settings, and application-specific properties. See the [format details](#file-format-details) below for what each upload path carries.

## Upload a file

<Info>**Upload limits:** Maximum file size is 1000 MB for all plans and formats</Info>

<Warning>
  If your file is in a cloud-synced folder (for example Google Drive, OneDrive,
  Dropbox, or iCloud Drive), make sure the file is fully downloaded to local
  disk before you upload.

  Some cloud clients show placeholder files before full local sync is complete.
  In that case, Speckle can read the file faster than the cloud client can
  finish downloading it, which can cause upload failures.
</Warning>

<Steps>
  <Step title="Create a project">
    Select the option to upload a file.

    <Frame>
      <img src="https://mintcdn.com/speckle/tH1u1dKYaNtn7MaZ/images/files/file-upload.png?fit=max&auto=format&n=tH1u1dKYaNtn7MaZ&q=85&s=d5ed9c11678b3656d179519fd92ce28f" alt="Upload file option" width="2358" height="498" data-path="images/files/file-upload.png" />
    </Frame>
  </Step>

  <Step title="Add your file">
    Drag and drop your file into the project. Speckle creates a new model with the file name.

    <Frame>
      <img src="https://mintcdn.com/speckle/tH1u1dKYaNtn7MaZ/images/files/file-uploading.png?fit=max&auto=format&n=tH1u1dKYaNtn7MaZ&q=85&s=87ac76a52f55122c3098f8a8949c1894" alt="File uploading progress" width="1160" height="434" data-path="images/files/file-uploading.png" />
    </Frame>
  </Step>

  <Step title="Upload new versions">
    To upload updated versions, select the dropdown menu on the model.

    <Frame>
      <img src="https://mintcdn.com/speckle/tH1u1dKYaNtn7MaZ/images/files/file-new_version.png?fit=max&auto=format&n=tH1u1dKYaNtn7MaZ&q=85&s=482cb9681f246f29e1a0a478773c77ab" alt="Upload new version option" width="638" height="658" data-path="images/files/file-new_version.png" />
    </Frame>
  </Step>
</Steps>

## Supported file formats

Speckle supports the following file formats:

<Note>
  If your Autodesk (or other) software can export a Navisworks Cache file (`.nwc`) or a Navisworks
  Document file (`.nwd`), you can upload it to Speckle without owning a Navisworks license.
</Note>

<Note>
  Want to help improve this flow? Join the user testing study for NWC and NWD uploads with ACC sync
  on the [User testing opportunities page](/get-involved/user-testing#nwc-nwd-acc-sync).
</Note>

<Warning>
  While the Navisworks parser is in Beta if the file size is over 200MB, the sync may not always
  succeed. Treat Navisworks sync as a beta release and expect occasional failures, especially for
  very large files.
</Warning>

| Format                        | Extension | Status |
| ----------------------------- | --------- | ------ |
| IFC                           | .ifc      | ✔︎     |
| Rhinoceros 3D                 | .3dm      | ✔︎     |
| SketchUp                      | .skp      | ✔︎     |
| AutoCAD                       | .dwg      | ✔︎     |
| Drawing Exchange Format       | .dxf      | ✔︎     |
| MicroStation                  | .dgn      | ✔︎     |
| 3D Studio                     | .3ds      | ✔︎     |
| SolidWorks Part               | .sldprt   | ✔︎     |
| STEP                          | .stp      | ✔︎     |
| STEP                          | .step     | ✔︎     |
| Point Cloud                   | .e57      | ✔︎     |
| 3D Manufacturing Format       | .3mf      | ✔︎     |
| Additive Manufacturing Format | .amf      | ✔︎     |
| Filmbox                       | .fbx      | ✔︎     |
| IGES                          | .igs      | ✔︎     |
| IGES                          | .iges     | ✔︎     |
| Wavefront                     | .obj      | ✔︎     |
| Polygon File Format           | .ply      | ✔︎     |
| DirectX                       | .x        | ✔︎     |
| Revit                         | .rvt      | ✔︎     |
| Navisworks Cache              | .nwc      | ✔︎     |
| Navisworks Document           | .nwd      | ✔︎     |

<Warning>
  In Forma Data Management (ACC) sync, coordination system and reference point selection apply
  **only** to **Revit** (`.rvt`) files. IFC and Navisworks ACC syncs do not use those controls. If
  you do not change the Revit setting, the default behaviour still applies. For coordination
  workflows that rely on specific Revit coordinate handling and connector-level control, use the
  [Revit connector](/connectors/revit/revit).
</Warning>

### Unit Conversion

For several file formats, the Unit system of the source file will be automatically detected and preserved when sending through Speckle.

* IFC ✔︎
* 3dm ✔︎
* DGN ✔︎
* SKP ✔︎
* STP ✔︎
* FBX ✔︎

Other formats have a different behaviour:

| **Format** | **Behaviour**                |
| ---------- | ---------------------------- |
| DWG        | Geometry is scaled to meters |
| 3DS        | Assuming file is in cm       |
| OBJ        | Assuming file is in mm       |

## File format details

### IFC

IFC files are converted to Speckle format with support for attributes, property sets, and quantities.

<Info>**Supported versions:** IFC2x3, IFC4, IFC4x1, IFC4x2, IFC4x3</Info>

<Check>
  Features:

  * Element and element type attributes
  * Property sets
  * Element quantities
  * **IFCSpaces** are published as volumetric geometry
</Check>

<Info>
  Known limitations:

  * IFC2x2\_FINAL and Release Candidate versions aren't supported
  * Alternative formats such as XML, ZIP, and databases aren't supported
  * 2D types like IfcAnnotation aren't currently supported
</Info>

### Rhino (3DM)

Rhino files maintain geometry and layer structure when uploaded.

<Note>
  If you need object names, user strings, render materials or named views, publish with the [Rhino
  connector](/connectors/rhino) instead.
</Note>

<Info>
  Known limitations:

  * Rhino 9 files aren't supported
  * Dynamic text isn't supported
</Info>

### SketchUp (SKP)

SketchUp models are converted with geometry and basic organization preserved.

<Note>
  If you need SketchUp attributes, publish with the [SketchUp connector](/connectors/sketchup)
  instead.
</Note>

<Info>
  Known limitations:

  * Attributes aren't imported
  * Dynamic components may not transfer correctly
</Info>

### DWG and DXF

Upload AutoCAD drawing files directly.

<Note>
  If you need object properties such as xdata carried through, publish with the [AutoCAD
  connector](/connectors/autocad) instead.
</Note>

<Info>
  Known limitations:

  * Large files may take longer to process
  * Dynamic text isn't supported
</Info>

### Wavefront (OBJ)

OBJ files are converted with geometry preserved.

<Info>
  Known limitations:

  * Materials aren't supported
</Info>

## FAQ

<AccordionGroup>
  <Accordion title="Why are my models in the wrong location?">
    Direct uploads convert models using Internal Origin and do not apply Revit Shared Coordinates. Uploaded models are not placed in a coordinated space. For coordination workflows that rely on Shared Coordinates, use the [Revit connector](/connectors/revit/revit) to publish and load models so coordinate modifications are preserved.
  </Accordion>

  <Accordion title="Can I download uploaded files?">
    Yes, file downloads are available. To download a file

    1. Select the dropdown menu (**...**) on the model.
    2. Select **View uploads**.
    3. Select **Download** next to the version you want.
  </Accordion>

  <Accordion title="My file is too large to upload">
    The limits on file uploads are currently **1000MB** for all plans and all formats.
  </Accordion>

  <Accordion title="Why is my file stuck processing?">
    We use a queue system to process files, so it can take awhile to generate the Speckle model after you upload your file. If you do not see your model after a long time, this may be caused by faulty items inside your file. Please report your problem in our [Community Forum](https://speckle.community/c/help) and include the following information:

    * Your file type and version
    * Your failed file
  </Accordion>

  <Accordion title="Will you support additional formats?">
    We're always looking to expand format support. Let us know which formats you'd like to see in future releases.
  </Accordion>
</AccordionGroup>