> For the complete documentation index, see [llms.txt](https://docs.chirpwireless.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chirpwireless.io/dashboards/adding-widgets/digital-building-twin/importing-a-dxf-plan.md). # Importing a Floor Plan If you already have a floor plan of your home — from when you bought the place, from a renovation, from an estate-agent listing — you don't have to draw your home from scratch. The editor can read a **DXF** file, the standard format that design and drawing programs export, and turn it straight into walls. It's the quickest route to an accurate model: the layout comes in already shaped and to scale, and you get to spend your time on the fun part — furnishing rooms and connecting sensors. ## What you need * A `.dxf` file of your floor plan. Architects, builders, and home-design apps can all export DXF. * The file is read right in your browser. Nothing is sent anywhere until you save the widget. ## Bringing in a file 1. On the bottom toolbar, click **Build**, then click **Trace from map** — the import window is reached from the same building-tools row. 2. In the import window, click **Choose file** and pick your `.dxf` file. 3. The window reads the file and shows you a **preview** of the walls it found, so you can check it looks right before anything is added. 4. Have a look at the **Options** and the count of what was found (below). 5. Click **Import**. The plan's lines become walls, placed on the floor you're currently working on. If the file can't be read, the window will tell you. If it reads but doesn't contain any walls, it says that too — some plan files only hold labels and measurements, with no actual walls. ## Options Two settings control how the plan is read: * **Source unit** — the unit your plan was drawn in: **Millimeters**, **Centimeters**, **Meters**, **Inches**, **Feet**, or **Unitless**. The editor reads the unit from the file when it can and fills this in for you; change it if the file got it wrong. This is the setting that decides whether your home comes in at the right size — if the imported plan looks far too big or far too small, the source unit is almost always why. * **Arc segments** — how smoothly curved lines are drawn, since walls are made of straight pieces: **Low**, **Medium**, or **High**. Medium is fine for most homes. The preview updates every time you change a setting, so you can get the size right just by looking. ## What was found The window shows a count of what the import did — how many **Walls** it created, how many curved shapes it approximated, and how many **Skipped entities** it left out. **Warnings** explain anything that was dropped. A few skipped items is completely normal: a plan file carries lots of things that aren't walls — text, dimension lines, furniture symbols — and only the walls belong in your model. ## After importing The imported walls work exactly like walls you draw yourself. Click any of them to set the height, thickness, and material, add doors and windows, and keep building. If something's not right, **Undo** (Ctrl+Z) takes the import back out so you can change the source unit and try again. A nice workflow: import the shell from the plan file, switch to the flat **2D view** to check the rooms, then draw any inside walls the plan didn't have — and you're ready to furnish. ## Tips * If your home imports at the wrong size, fix the **Source unit** and import again. * Importing a multi-floor home? Add the floor first (see [Floors and levels](/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md)), switch to it, then import that floor's plan. * The tidier the plan file, the cleaner the import. If a plan is crowded with extra layers, exporting just the walls from the design app gives the best result. ## See also * [Drawing your home](/dashboards/adding-widgets/digital-building-twin/drawing-your-building.md) — Draw or adjust walls by hand * [Tracing from the map](/dashboards/adding-widgets/digital-building-twin/tracing-from-the-map.md) — Build from a satellite map instead * [Floors and levels](/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md) — Import each floor onto its own level --- # 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.chirpwireless.io/dashboards/adding-widgets/digital-building-twin/importing-a-dxf-plan.md?ask=&goal= ``` `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.