> For the complete documentation index, see [llms.txt](https://docs.jmapcloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jmapcloud.io/en/jmap-cloud-plugin-for-qgis/user-guide/opening-a-project.md).

# Opening a Project

To open a JMap Cloud project in QGIS:

1. Click **Web → JMap Cloud → Open project** to open the **Open project** interface.
2. Select the JMap Cloud project you want to open. The interface displays all projects in your organization that you can access.

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

When the plugin opens a JMap Cloud project, it retrieves all the information: layer data, styles, layer order, layer groups, etc.&#x20;

{% hint style="info" %}
The QGIS project is identical to the JMap Cloud project.
{% endhint %}

When opening the project, you must select one of three options:

* **Default**: The project's layer data will be loaded as vector tiles and/or GeoJSON, as defined in the JMap Cloud project.
* **All in GeoJSON**: The project's layer data will be loaded in GeoJSON format only.
* **All in Vector Tiles**: The project's layer data will be loaded as vector tiles only.

### Notes

* WMS/WMTS layers have sub-layers. QGIS cannot retrieve all sub-layers in a single raster file layer. The extension therefore creates a layer group containing all the sub-layers of the WMS/WMTS layer.
* QGIS vector tile layers do not support rule-based styles. The extension therefore creates a layer group containing one vector tile layer for each style rule of the layer.
* If a vector layer can be edited based on your permissions, it is served as a GeoJSON vector layer; otherwise it is served as MVT. The reason is that vector layers can be edited in QGIS while MVT layers cannot, but MVT layers offer faster rendering.
* All layers depend on JMap Cloud API endpoints. This means the layer will not work if the user is not connected or if there is no internet connection.

## Legend Icons

The plugin can use the **Layer tree icon** plugin to improve legend icons.

Some icons are modified to make the legend more readable. If the **Layer tree icon** plugin is not installed, the default icons are displayed.

<table data-header-hidden><thead><tr><th width="192" valign="top"></th><th width="227" align="center" valign="top"></th><th width="233" align="center" valign="top"></th></tr></thead><tbody><tr><td valign="top"> </td><td align="center" valign="top"><strong>Created by the plugin</strong></td><td align="center" valign="top"><strong>Replaced by</strong> </td></tr><tr><td valign="top">Raster layer groups</td><td align="center" valign="top"><img src="/files/BGxJE4HhPoaAzrrfpBpE" alt="image_2025-02-24_092055973.png"></td><td align="center" valign="top"><img src="/files/cdJaKBu4NXfvL2MU3mcO" alt="image-20250224-142213.png"></td></tr><tr><td valign="top">MVT layer groups</td><td align="center" valign="top"><img src="/files/BGxJE4HhPoaAzrrfpBpE" alt="image_2025-02-24_092055973.png"></td><td align="center" valign="top"><img src="/files/jyBEYP53vz9QAwHR4REb" alt="image-20250224-142433.png"></td></tr><tr><td valign="top">MVT layer</td><td align="center" valign="top"><img src="/files/8bRfelBcB9kX3sA6C3OT" alt="image-20250224-142810.png"></td><td align="center" valign="top"><img src="/files/WpK7tMccPOIWcOc9FkDk" alt="image-20250224-142849.png"></td></tr><tr><td valign="top">Legend folder</td><td align="center" valign="top"><img src="/files/BGxJE4HhPoaAzrrfpBpE" alt="image_2025-02-24_092055973.png"></td><td align="center" valign="top"><img src="/files/4ezrXoRW8BLxhu2BcvRY" alt="image-20250224-142538.png"></td></tr></tbody></table>
