> For the complete documentation index, see [llms.txt](https://docs.betterbuilding.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.betterbuilding.io/user-guide/3d-building/import.md).

# Import

## Import a gbXML

To import a model, first follow the steps outlined in [Create a 3D Design](/user-guide/3d-building/create-a-3d-design.md) to set up your project. Once your design space is ready, navigate to 'Upload Model' and left-click to begin the import process.

You’ll be prompted to upload a file in one of the supported formats: GBXML, IDF, or EPJSON. Make sure you have a file ready to use – if not, a sample file is provided below for testing purposes.

<figure><img src="/files/HHHFy5WYSIK0LO7itW0Z" alt=""><figcaption></figcaption></figure>

Download the gbXML sample below and save it to your desktop. When you're ready, click 'Select Model' and locate the file named b`ristol-clifton-downs-fixed.xml`.' Then click 'Upload'.

{% file src="/files/rJr4sICcYUTzMdkHWSMy" %}

<figure><img src="/files/TwqH2QLb9nXTirhmypQW" alt=""><figcaption></figcaption></figure>

Click Open, then click Upload to begin the import. This starts the process of converting your GBXML file into IDF format for energy simulation, which will also form the basis for Radiance daylight modelling.

<figure><img src="/files/qnGsTSH7WUhjO91NwAqA" alt=""><figcaption></figcaption></figure>

Once your model appears in the interface, hit 'Save' and navigate to 'Levels' and locate the 'Detect Levels' option. Left-click, accept the default 'Floor Level Tolerance' of 0.1, and click 'Detect' to finalise floor level detection. You will then be able to hover over 'Level' and 'Zones' to automatically detect there location in the model. Hit 'Save'.

<figure><img src="/files/ZbT4sXZH70v0o6PwEPkx" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/h3RFUxj2M43zg5ftcIQF" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/EeWYX1BnZV7eEGwF7JyR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6fJdaRfe4xzpP82n0FhV" alt=""><figcaption></figcaption></figure>

## Import a Better Building 2D Model

If you prefer to work in 2D, you can generate an EnergyPlus-compatible file by exporting your 2D building design as an IDF file.&#x20;

To do this, navigate to the 'Options' menu next to Simulation within the 2D workspace. Left-click and select 'EnergyPlus IDF' from the available export formats.

<figure><img src="/files/Rashq5xG1psL3dL1taUD" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/77kS35FR8YV3UVPrstwN" alt=""><figcaption></figcaption></figure>

You’ll then be prompted to choose the building type,  this can be either 'Proposed' and 'Reference' or Proposed only, depending on your requirements. Once selected, click 'Create'. The system will generate and download the IDF file to your designated storage location for later use.

<figure><img src="/files/6ci0mnIc1bywJ4Bv54dC" alt=""><figcaption></figcaption></figure>

When you're ready to move into 3D, return to your 3D model or create a new one. From there, simply repeat the model upload process using the downloaded IDF file. This allows you to continue working with your design in a 3D environment while retaining the input from your 2D setup. This workflow may be suitable for quicker specification.

## Update a model

When changes are made to a 3D design, the updated model can be re-imported without affecting any previously completed work, such as specifications. The platform automatically identifies geometric changes within the model and preserves all existing specifications. This process ensures that no work is lost or duplicated, reducing the risk of rework and saving time during the design process.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.betterbuilding.io/user-guide/3d-building/import.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.