Support tip: Downloading a previous version of your project

One of the great features that we offer users on our Professional and Team tiers  is the ability to access project history. We don’t like to think about things going wrong, but sometimes you may need to revert to a previous version of your project for some reason. This can be as simple as going to the web-based dashboard, downloading the version of your project you want to revert to and creating a new project with the downloaded file using the QGIS Plug-in.

How do I download larger projects?

You might find that you get an error message when you try to download the project file from the dashboard because the project size is too large. There is a limit on the dashboard of 1GB for project size to be downloaded. However, larger projects can be downloaded using the Python Console in QGIS. Don’t worry if you are not proficient with Python, we’re going to show you exactly how to do this, all you need to do is follow these steps:

1. Open QGIS and make sure you are logged in to the Mergin Maps plugin

2. Open the Python console by clicking on the ‘Python’ icon or pressing ‘CTRL+ALT+P’ on your keyboard.

3. Click on the ‘Show Editor’ button to open the script editor.

4. Enter the script in the box below into the script editor that opens on the right hand side, replace the values for the following with your information:

  • my_username
  • my_password
  • my_workspace
  • my_project
  • project_version
  • work_dir - only change the directory path inside the first set of quotation marks and end your directory path with a double backslash '\\'

from Mergin.mergin import MerginClient
my_username = "your username"
my_password = "your password"
my_workspace = "your workspace"
my_project = "project name"
project_version = "v2"
work_dir = r"C:\desired\path\to_download" + f"{my_project}"
mc = MerginClient(login=my_username, password=my_password)

Once you have entered your information, you can optionally save the script as a file in your project folder so that you can use it again if needed.

5. Press the green 'Run Script' button above the window on the right and it will run the script and download the project to the folder you specified.

You might also like

Mergin Maps

Mergin Maps app is getting a fresh new look

March 28, 2024

Mergin Maps

QField vs. Mergin Maps - App Comparison

March 1, 2024

Mergin Maps

Hello from Mergin Maps!

February 13, 2024

Mergin Maps

Mergin Maps 2023: our year in review

December 28, 2023


Mergin Maps is now faster and more stable than ever

November 15, 2023


Download tiles for offline background maps in five steps

October 30, 2023


We've partnered with MarXact for high-precision surveying in Mergin Maps

October 27, 2023


Come see us at INTERGEO 2023 in Berlin

September 29, 2023

Mergin Maps

Mergin Maps Gets a Brand Refresh

September 27, 2023

Mergin Maps

We’ve added the ability to customise photo names in Mergin Maps!

August 31, 2023


You asked for it and we delivered… Position tracking in Mergin Maps!

August 22, 2023

Mergin Maps

Features wishlist - Help us help you!

July 27, 2023

Mergin Maps

Check out the Mergin Maps interview on App of the Day

May 4, 2023


Mergin Maps hope to see you at GeoBusiness London 2023

May 2, 2023

Mergin Maps

Worried about using open-source geospatial software for your business? Mergin Maps support is here for you!

April 28, 2023

Mergin Maps

Camptocamp partners with Mergin Maps to deliver open source GIS solutions

April 25, 2023

Mergin Maps

Subscription tiers are going to change

April 18, 2023

Mergin Maps

Mergin Maps Community and Enterprise Editions

March 31, 2023

Mergin Maps

Introducing Workspaces: Simplified Collaboration

January 31, 2023

Mergin Maps

Mergin Maps: a year in review (2022)

December 20, 2022

Mergin Maps

Mergin Maps in MapScaping podcast

December 15, 2022


View and track changes in QGIS

December 14, 2022

By clicking “Accept All Cookies”, you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. View our Cookie Policy for more information. Deny cookies here.