# How to Fix a Broken Project
since Mobile 2.0.0Do you get an error message when trying to open a project in Mergin Maps Input? There can be multiple reasons for what went wrong. Here we will try to guide you through some basic steps that can help you.
The error is caused by a bug, which should be fixed in QGIS versions 3.20, 3.18.3 and 3.16.7 and higher, so only projects created in older versions of QGIS are affected. Unfortunately, saving the project in a newer QGIS version is not enough to fix it.
DETAILS
From a technical point of view, the issue is caused by a bug in parsing Mapbox GL style for vector tile layers that caused issues when loading Qt5-based QGIS projects from older QGIS versions in Qt6-based QGIS. This bug was fixed and should not appear in QGIS versions 3.20, 3.18.3 and 3.16.7 and higher.
Qt6 has been used in Mergin Maps Input since version 2.0.0. Thus, if you use a QGIS project that was created in older QGIS versions, you may encounter this error.
When trying to identify what to fix in your project, look for these:
- a vector tile layer with JSON style
- when a rule has
text-size
with "stops" - data-defined text size gets badly stored expression (as 0x01 character instead of the proper expression)
There is a high chance that these settings are the culprit behind the error!
To fix the project:
Open your Mergin Maps project in QGIS.
Remove problematic vector tile layers from the project.
If you use online vector tiles, navigate to Vector Tiles in the Browser panel and create a new vector tiles connection to the data source.
DETAILS
You may also inspect the Style URL in the Vector Tiles Connection.
For instance, if the Style URL looks like this (Qwant Maps settings used here):
styleUrl=https://raw.githubusercontent.com/QwantResearch/qwant-basic-gl-style/master/style.json&type=xyz&url=https://www.qwant.com/maps/tiles/ozbasemap/%7Bz%7D/%7Bx%7D/%7By%7D.pbf&zmax=14&zmin=0
try removing the part of the link afterstyle.json
to get:
styleUrl=https://raw.githubusercontent.com/QwantResearch/qwant-basic-gl-style/master/style.json
Add the layers back to the project.
Offline vector tiles should be located in the project folder on your computer. Online vector tiles connections can be managed in Vector Tiles in the Browser.
Save and sync the project.
WARNING
Copying styles from problematic layers and pasting them to other layers can cause the error to occur again. Unless you know what exactly causes the issues and are able to fix that, you might need to recreate the styles.