> 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="https://3291879974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9n1KCuTyIKwSpZcPcC6l%2Fuploads%2FmwonoGGQ2KIKZXzqinhk%2FEN-Fig2.png?alt=media&amp;token=20e62246-0f21-474f-bbb7-7296e6f2971c" 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="https://3291879974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9n1KCuTyIKwSpZcPcC6l%2Fuploads%2F8doCn3bEt5fjJZoWvpgL%2Fgroup.png?alt=media&amp;token=caca8bdb-5495-43f8-b89b-675fe133e940" alt="image_2025-02-24_092055973.png"></td><td align="center" valign="top"><img src="https://3291879974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9n1KCuTyIKwSpZcPcC6l%2Fuploads%2FDxKcTkLO4QpOaUWnEeB1%2Fgroup_to_raster_group.png?alt=media&amp;token=f7e5b08c-4ead-445d-a3fd-d6f8321e8de1" alt="image-20250224-142213.png"></td></tr><tr><td valign="top">MVT layer groups</td><td align="center" valign="top"><img src="https://3291879974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9n1KCuTyIKwSpZcPcC6l%2Fuploads%2F8doCn3bEt5fjJZoWvpgL%2Fgroup.png?alt=media&amp;token=caca8bdb-5495-43f8-b89b-675fe133e940" alt="image_2025-02-24_092055973.png"></td><td align="center" valign="top"><img src="https://3291879974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9n1KCuTyIKwSpZcPcC6l%2Fuploads%2FJToTCUV2xOcrWlPlCFcx%2Fgroup_to_MVT_group.png?alt=media&amp;token=197d8824-80d7-4822-a3b2-ca9e1c6ab95c" alt="image-20250224-142433.png"></td></tr><tr><td valign="top">MVT layer</td><td align="center" valign="top"><img src="https://3291879974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9n1KCuTyIKwSpZcPcC6l%2Fuploads%2Fs5V7cvpxUvpJ91nAblHw%2FMVT.png?alt=media&amp;token=a845d1d9-1f7b-4b83-9ff5-938c2f6bb5ad" alt="image-20250224-142810.png"></td><td align="center" valign="top"><img src="https://3291879974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9n1KCuTyIKwSpZcPcC6l%2Fuploads%2FSeesrUldcaN7og7dL44s%2FMVT_to_style.png?alt=media&amp;token=5fc3cf1a-364f-464c-959d-54199575b996" alt="image-20250224-142849.png"></td></tr><tr><td valign="top">Legend folder</td><td align="center" valign="top"><img src="https://3291879974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9n1KCuTyIKwSpZcPcC6l%2Fuploads%2F8doCn3bEt5fjJZoWvpgL%2Fgroup.png?alt=media&amp;token=caca8bdb-5495-43f8-b89b-675fe133e940" alt="image_2025-02-24_092055973.png"></td><td align="center" valign="top"><img src="https://3291879974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9n1KCuTyIKwSpZcPcC6l%2Fuploads%2Fo9xFpr4A8COWvE1N85bS%2Fgroup_to_folder.png?alt=media&amp;token=a3adeab2-f884-446d-be4d-a2a2117b4eb1" alt="image-20250224-142538.png"></td></tr></tbody></table>
