> 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/2d-building/drawing/manage-underlays.md).

# Manage Underlays

An underlay is usually an architectural or mechanical plan, imported as a PNG file. You’ll trace over it to define thermal zones or spaces in the drawing area.

PNG works best as it keeps images sharp without losing detail. It’s ideal for clean lines, edges and transparency. If you have a PDF, convert it using your preferred software or a free tool like [pdf2png.com](https://pdf2png.com) for quick, high-quality results.

Keep your PNG under 1 MB. After importing, just calibrate and set a few preferences to start drawing. You’ll repeat the process for each zone and building level.

To be most useful, your underlay should show clear dimensions, orientation and all relevant areas.

## Import an Underlay

To import an underlay, click ‘Underlay’ in the drawing space ribbon, then press ‘+ Underlay’ and select your converted PNG file (ideally under 1 MB) from your local drive. Next, Click 'Add' to upload your inderlay.

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

## Delete an Underlay

To update an underlay, go to ‘Underlay’ in the drawing space ribbon and click the ‘x’ to delete the current one. Then, click ‘+ Add Underlay’ to upload a new PNG file from your local drive.

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

## Calibrate an Underlay

To calibrate an underlay, click ‘Calibrate Drawing’ in the drawing space ribbon. Left-click to mark the starting point, then hold and drag to the endpoint. Enter the known length and click ‘Calibrate’ to set the scale.

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

## Set Underlayer Opacity&#x20;

To set underlayer opacity, go to ‘Underlay’ in the drawing space ribbon and navigate to Opacity. Then set the Opacity between 1 (xero opacity) and 0 (full Opacity).

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

## Rotate Underlay

To rotate underlay, go to ‘Underlay’ in the drawing space ribbon and navigate to Rotation. Then set the Rotation between -180 and + 180.

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

## Position an Underlay

To position an underlay, click ‘Position Underlay’ in the drawing space ribbon. Hold left-click and drag inside underlay to change its position.  Hold left-click and drag underlay corners to change its size.

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


---

# 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/2d-building/drawing/manage-underlays.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.
