> For the complete documentation index, see [llms.txt](https://help.visuary.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.visuary.com/guide-visuary-en/plan-import/import-a-plan.md).

# Import a plan

Convert a JPG, PNG or PDF plan into an editable plan

*If you already have a floor plan of the Dwelling / Housing unit, Visuary can automatically convert it into an editable plan: the walls are redrawn, without having to trace them by hand.*

***

#### Import a plan <a href="#importer-un-plan" id="importer-un-plan"></a>

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZFcDkdPcFkKsLAju8DW3%2Fuploads%2F6EuMQqtdYO5bbSI2yqsc%2FImport1.mp4?alt=media&token=7ece41e6-4392-4ec7-945c-2daf8e160226>" %}
Import a plan
{% endembed %}

To import a plan:

1. From the page **Projects**, click on **New project**
2. Click on **Import a plan**. The **Reference plan** opens.
3. Click the button **Click to browse** and **select your file**, or drag it directly into the import Zone.

{% hint style="warning" %}
The plan must be in **format .jpg, .png or .pdf.**
{% endhint %}

#### Scale the plan

*Scaling is required before you can convert the plan.*

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZFcDkdPcFkKsLAju8DW3%2Fuploads%2FkUUUzLTmofIKl8BNFZkT%2FEchelle2.mp4?alt=media&token=8bb3ed4f-5b8e-4f09-8adf-9a222c66cfce>" %}
Scale the plan
{% endembed %}

To scale the plan:

1. **Select the orange Dimension by its ends and place it on a known length on the plan.** For maximum accuracy, choose the largest Dimension.
2. **Enter the measurement** in cm in the field "**Scaling**" located at the top left of your screen.
3. Click on "**Validate**".

{% hint style="info" %}
Need to correct the scale? Redo the scaling from the tab **Reference plan**, then convert the plan again.&#x20;

**Warning: the Existing floor plan will be reset with this new scale.**
{% endhint %}

#### Convert an imported plan

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZFcDkdPcFkKsLAju8DW3%2Fuploads%2FToE4XWnIWnfuBNf1AdFH%2FConvertir3.mp4?alt=media&token=f12bb577-1cb7-451c-a858-296f977c30f8>" %}
Convert an imported plan
{% endembed %}

To convert the plan:

1. Click on "**Convert to editable plan (beta)**"
2. Wait for the conversion. The message "*Your plan is being converted. This may take a few minutes.*" is displayed.
3. Once the conversion is complete, the plan opens in the tab **Existing floor plan**.&#x20;
4. The plan can be edited directly: you can start working on it.

{% hint style="warning" %}
Automatic plan import is limited according to your subscription:&#x20;

* **Without a subscription** : 2 conversions
* **Essentiel** : 5 conversions per month
* **Intégral** : 20 conversions per month

Your counter resets on the 1st of every month. To see how many conversions you have left this month, hover over the "**Convert to editable plan (beta)**" button with your mouse.&#x20;
{% endhint %}

{% hint style="info" %}
Do you prefer to redraw the plan yourself? Click "**Use as Layer**" instead: the plan will serve as support for [drawing over it](https://help.visuary.com/vos-premiers-projets-sur-visuary/dessiner-un-plan#pour-utiliser-un-plan-de-reference-suivez-les-etapes-detaillees-ci-dessous).&#x20;
{% endhint %}

#### Compare with the reference plan

*Plan conversion is currently in beta: the result may require some adjustments.*&#x20;

*Check the resulting plan by comparing it with the reference plan.*

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZFcDkdPcFkKsLAju8DW3%2Fuploads%2F0FTSydFmesrRWJpGxJuc%2FOpacit%C3%A94.mp4?alt=media&token=63069876-a397-4b72-a612-7ea810c7aa14>" %}
Compare with the reference plan
{% endembed %}

To compare the two plans:

1. Use the slider "**Opacity**" at the bottom of the screen to make the converted plan transparent and view the original plan underneath.
2. If necessary, correct the plan [by drawing the missing walls](https://help.visuary.com/le-plan/les-murs).&#x20;

{% hint style="success" icon="lightbulb" %}
We recommend **setting the plan opacity to 60%** which will let you view both the reference plan and the drawn plan.
{% endhint %}

#### Move the reference plan

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZFcDkdPcFkKsLAju8DW3%2Fuploads%2F7CFpEQlUQxICUVc0ipAl%2FD%C3%A9placer5.mp4?alt=media&token=5e9558c2-b6f4-4283-bae6-07f5116fde83>" %}
Move the reference plan
{% endembed %}

To move the reference plan on the Workspace:

1. **Hold down the Shift key** on your keyboard
2. While holding this key, click the reference plan to select it, then **move it by dragging your mouse**.

#### Hide the reference plan

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZFcDkdPcFkKsLAju8DW3%2Fuploads%2Fw7YV63e3HoSYF7kBN9qt%2FCalque6.mp4?alt=media&token=887819be-f7d1-4859-87cb-4811b0744a06>" %}
Hide the reference plan
{% endembed %}

To show or hide the original plan:

1. Click the '**eye icon**', at the bottom right, to display the Layer list.
2. Disable/enable the Layer "**Reference plan**".


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.visuary.com/guide-visuary-en/plan-import/import-a-plan.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.