MerginMaps / MerginMaps/qgis-plugin
File paths not updated when using 'Package current QGIS project' option
@JanCaha is already working on this.
Since Aug 8, 2025.
- Dominant language
- Python
- Stars
- 44
- Forks
- 20
- Avg merge
- 3d 12h
- Merged PRs (30d)
- 5
Description
When using the Mergin Maps plugin to upload an existing project using the 'Package current QGIS project' option, the paths to the newly created project's file paths are not updated in the new .qgz and .gpkg files. Instead, the project will still point to the original file paths resulting in unavailable layers when opening the project in the app for the first time or downloading it via the Mergin Maps Plugin on a separate machine. To reproduce this issue:
- Download the attached .zip file containing a simple survey project
- Extract the project from the .zip file
- Open the project_create.qgz file in QGIS (in the example, I used 3.34 LTR)
- Press the '+' button in on the Mergin Maps Plugin menu
- In the project creation dialogue, select the 'Package current QGIS project' option to create the project
- Click 'Next'
- In the next dialogue window, select a different directory for the 'Create Mergin Maps Project in:' than the current project directory and press 'Finish'
- Once the project creation is finished, download and open the project in the Mergin Maps mobile app and an error will appear stating that there are missing layers.
There is a workaround if this error occurs after creating the project. After finishing step 7 in the above sequence, go to the new project directory and open the project in QGIS. Then follow the steps provided in the QGIS documentation to fix the paths to the layer data sources for each of the layers in your project and synchronise the changes in the plugin.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.