From 3eec1ae45c24b73ae98e63aec329e9cfe551c024 Mon Sep 17 00:00:00 2001 From: Alexandra Date: Mon, 7 Sep 2026 15:33:11 +0200 Subject: [PATCH] add QGIS 4 and QGIS3 compability note --- src/gis/features/index.md | 12 +++++++++++- src/setup/install-qgis/index.md | 10 ++++++++++ 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/src/gis/features/index.md b/src/gis/features/index.md index 94b62e20..09a0da68 100644 --- a/src/gis/features/index.md +++ b/src/gis/features/index.md @@ -10,7 +10,17 @@ Project preparation is done in QGIS. For more information about loading layers, In addition, uses some of the features within the project to help visualise, capture and browse the data. Here is an overview of the project preparations steps. -:::tip +:::warning QGIS 4 and QGIS 3 compatibility: what to check before upgrading +QGIS 4 stores some settings, such as the map canvas CRS, in a format QGIS 3 cannot read. In QGIS 3 these appear as unset. The same applies to settings from our : options you enable in QGIS 4, like map sketching, custom photo naming or position tracking, will show as disabled when the project is opened in QGIS 3. The compatibility goes one way only. QGIS 4 reads entries written by QGIS 3, but not the other way round. + +This affects QGIS desktop only. The reads these entries correctly, whether they were set in QGIS 3 or QGIS 4. + +**What we recommend** +- Make sure everyone on your team who works in QGIS uses the same major version, either QGIS 4 or QGIS 3. +- If you're migrating to QGIS 4, migrate the whole team at the same time. That avoids the problem entirely. +::: + +:::tip Mergin Maps tutorials Our tutorials can guide you through QGIS project preparation step by step. In [Creating a Project in QGIS](../../tutorials/creating-a-project-in-qgis/) you will learn how to create a project, add new layers and configure a basic form. diff --git a/src/setup/install-qgis/index.md b/src/setup/install-qgis/index.md index 2a4c3880..2f2a3b5b 100644 --- a/src/setup/install-qgis/index.md +++ b/src/setup/install-qgis/index.md @@ -29,3 +29,13 @@ QGIS is a powerful tool with a great community that can help you achieve a lot. We recommend using and to get familiar with QGIS and its functionality. ::: + +:::warning QGIS 4 and QGIS 3 compatibility: what to check before upgrading +QGIS 4 stores some settings, such as the map canvas CRS, in a format QGIS 3 cannot read. In QGIS 3 these appear as unset. The same applies to settings from our : options you enable in QGIS 4, like map sketching, custom photo naming or position tracking, will show as disabled when the project is opened in QGIS 3. The compatibility goes one way only. QGIS 4 reads entries written by QGIS 3, but not the other way round. + +This affects QGIS desktop only. The reads these entries correctly, whether they were set in QGIS 3 or QGIS 4. + +**What we recommend** +- Make sure everyone on your team who works in QGIS uses the same major version, either QGIS 4 or QGIS 3. +- If you're migrating to QGIS 4, migrate the whole team at the same time. That avoids the problem entirely. +:::