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

# IFC file upload

> Bring a model into Real-Time LCA by uploading an IFC export.

If you can't (or don't want to) stream your model through Speckle, you can upload an **IFC** export instead. Real-Time LCA reads the IFC entities, groups them into BIM types, and exposes their quantities for material mapping — just like a Speckle stream.

## When to use IFC upload

* Your authoring tool doesn't have a Speckle connector available.
* You're working with a model handed over by an external consultant.
* You want a quick one-off LCA from a static export rather than a live design link.

## Prepare the export

* Use **IFC 4** (or IFC 2x3) when possible.
* Include the property sets that carry your type identifier (the parameter Real-Time LCA uses to group elements, by default `BIMTypeCode`).
* Export quantities (`BaseQuantities`) so Real-Time LCA can read areas, volumes, and lengths directly from the file.

## Open the upload menu

Open the project and switch to the **Material Mapping** tab. Click the upload icon next to **Select** above the Building Component Inventory to open the menu, then choose **IFC upload**.

<Frame caption="Material Mapping — upload menu with Excel upload and IFC upload">
  <img src="https://mintcdn.com/real-timelca/0tVSFkdSMd9pjXLx/images/user-guide/IFC%20upload%20-%20menu%20option.png?fit=max&auto=format&n=0tVSFkdSMd9pjXLx&q=85&s=cbc4af2ca45ed2b0498e9591c2135df4" alt="Material Mapping page with the upload icon expanded showing Excel upload and IFC upload options." width="3104" height="2224" data-path="images/user-guide/IFC upload - menu option.png" />
</Frame>

## Choose the model

The **Upload IFC file** modal opens. Use the **Upload to model** dropdown to pick which Speckle model the IFC should be attached to — the file's BIM types will be added to that model's slice of the Building Component Inventory.

<Frame caption="Upload IFC file modal">
  <img src="https://mintcdn.com/real-timelca/0tVSFkdSMd9pjXLx/images/user-guide/IFC%20upload%20-%20upload%20modal.png?fit=max&auto=format&n=0tVSFkdSMd9pjXLx&q=85&s=c1cd699e0bbebdc3e3113912f9f10b7f" alt="Upload IFC file modal with the Upload to model dropdown set to architectural and a drag-and-drop area for the .ifc file." width="3104" height="2224" data-path="images/user-guide/IFC upload - upload modal.png" />
</Frame>

The dropdown lists every model configured on the project. Pick the one that matches the discipline of the IFC export (for example, *structural* for a structural engineer's hand-off).

<Frame caption="Upload to model dropdown">
  <img src="https://mintcdn.com/real-timelca/0tVSFkdSMd9pjXLx/images/user-guide/IFC%20upload%20-%20model%20dropdown.png?fit=max&auto=format&n=0tVSFkdSMd9pjXLx&q=85&s=d069bb1bd918b19fafa9b43faa340c38" alt="Upload to model dropdown open showing architectural, ifc, and structural model options." width="3104" height="2224" data-path="images/user-guide/IFC upload - model dropdown.png" />
</Frame>

## Upload the file

Drop your `.ifc` file in the **Click to upload or drag and drop** area, or click to browse. The file appears in the drop zone once it has been added.

<Frame caption="IFC file added to the upload modal">
  <img src="https://mintcdn.com/real-timelca/0tVSFkdSMd9pjXLx/images/user-guide/IFC%20upload%20-%20new%20model%20selected.png?fit=max&auto=format&n=0tVSFkdSMd9pjXLx&q=85&s=bbf6172b00b578ae650acd791378ac1e" alt="Upload IFC file modal with the ifc model selected and an Office_STR.ifc file staged in the drop zone." width="3104" height="2224" data-path="images/user-guide/IFC upload - new model selected.png" />
</Frame>

Click **Upload** to start the import. Use **Cancel** or **×** to abort without changes.

<Tip>
  Watch the linked tutorial video in the modal before your first upload if you're unsure how to prepare the IFC export.
</Tip>

## Wait for processing

Real-Time LCA parses the file, groups elements into BIM types, and reads their quantities. You can keep using the app in the background — the project updates automatically when processing finishes.

<Frame caption="Processing IFC file">
  <img src="https://mintcdn.com/real-timelca/0tVSFkdSMd9pjXLx/images/user-guide/IFC%20upload%20-%20processing.png?fit=max&auto=format&n=0tVSFkdSMd9pjXLx&q=85&s=0ae13a0d159071509db31641b2ed2d33" alt="Processing IFC file dialog with a success toast confirming the file was imported." width="3104" height="2224" data-path="images/user-guide/IFC upload - processing.png" />
</Frame>

When the import is complete you'll see a confirmation. Click **Close** to return to the Building Component Inventory.

<Frame caption="Import complete">
  <img src="https://mintcdn.com/real-timelca/0tVSFkdSMd9pjXLx/images/user-guide/IFC%20upload%20-%20import%20complete.png?fit=max&auto=format&n=0tVSFkdSMd9pjXLx&q=85&s=c1f36a9b07ac06a9cbf1e9eda9868e62" alt="Import Complete dialog confirming the IFC file has been processed and the project has been updated automatically." width="3104" height="2224" data-path="images/user-guide/IFC upload - import complete.png" />
</Frame>

## Review the imported BIM types

Each BIM type from the IFC now appears in the Building Component Inventory. Click a type to open its properties — Real-Time LCA shows the quantities it read from the file (square meters, cubic meters, meters, pieces) and the classification it inferred. From here, map the type to a material or construction the same way you would for a Speckle stream.

<Frame caption="BIM type properties after IFC import">
  <img src="https://mintcdn.com/real-timelca/0tVSFkdSMd9pjXLx/images/user-guide/IFC%20upload%20-%20type%20properties.png?fit=max&auto=format&n=0tVSFkdSMd9pjXLx&q=85&s=08fe8d1ce3a721756d82c3f049c81b67" alt="Type properties panel for an imported IFC BIM type showing classification, type name, description, and quantity fields populated from the IFC file." width="3104" height="2224" data-path="images/user-guide/IFC upload - type properties.png" />
</Frame>

## Updating the model

Uploading a new IFC creates a new version of the model's data. Existing material mappings carry over for BIM types that still match by identifier.
