Vai al contenuto

QField storage management

On the QField home screen, you have two options to open a project.

  • QFieldCloud projects: The first option is to access a project stored on QFieldCloud How to set up and work with QFieldCloud is explained in the next chapter.
  • Open local file: The second option involves copying a working copy of the QGIS project file from a laptop or PC (the source device) to the phone or tablet (the target device). On the target device, you can access and edit this local copy using QField and eventually copy the edited version back to the desktop or to an alternative cloud storage service.

There are various possibilities to import copies of project files and datasets from your desktop or a cloud storage for field-data collection.

1. Copying project over to the QField target device

On both the Android and iOS devices, installing QField creates a folder called QField, containing three folders; Imported Datasets, Imported Projects and QField.

Workflow

  1. Before copying or downloading your project, your project and files need to be packaged into a readable format for QField.
  2. If you are using QFieldCloud just upload your project and files and make sure they are saved in the same data folder.
  3. If you are manually transferring your project, follow the steps under QFieldSync

  4. If you do NOT use QFieldCloud copy the project to your device to the folder called Imported Projects.

You can find the folder under the following paths:

  • Android path: Android/data/ch.opengis.qfield/files/Imported Projects
  • iOS path: On My iPhone/QField/Imported Projects

Copying the packaged project over to the corresponding folder of each device can be done in several ways.

Android

Transfer via USB-cable

  1. Connect both devices using a USB cable and follow the instructions on how to transfer files between your computer and the android device. On most devices plugged into a computer via USB cable connection, the path will be <drive>:/Android/data/ch.opengis.qfield/files/. There, users will find both the Imported Datasets and Imported Projects folders within which the QGIS projects and datasets should be placed. Changes done to the project content and datasets are saved in the files found in these locations.

Google Drive (and other cloud storage services)

The advantage of using Google Drive is that both the source device and target device have shared access to a central working directory containing the current project files.

Workflow

  1. Prepare and package a QGIS project on your laptop or computer.
  2. Upload the project to Google Drive.
  3. Download the project to the target devices and collect data.
  4. Upload the changed project (or parts of the project) from the target devices back to the cloud and replace the old files with the new ones.
  5. Download the project back on to the source device.

Note

When working with Google Drive, it may be helpful to create a dedicated folder that contains all the projects. An equivalent of this folder can then also be created on the target device, to which the QGIS projects can be downloaded and saved in.

Share via Bluetooth

Wireless transfer of files is also possible by sharing files via a Bluetooth connection.

Versione per iOS

Transfer via USB-cable

Transferring files from MacBooks or iMacs to iPhone using a cable is not straightforward, since it is not possible to access individual files in the QField directory.

Workflow

  1. Copy the entire folder Imported Projects from your iOS target device (iPhone, iPad) over to your source device (iMac).
  2. Copy the packaged QGIS project file into the copied Imported Projects folder.
  3. Copy back and replace the old Imported Projects folder with the new one.

iCloud (and other cloud storage services)

An efficient way to synchronize projects is to use iCloud as a shared workspace to download and upload project files. It is not possible to import projects from folders inside the iOS QField application. Instead, the new project files have to be saved in the Imported Projects folder so that QField can access them.

Workflow

  1. On the source device, upload the packaged project to a folder on iCloud (titled e.g. "QField projects").
  2. On the target device, download the packaged project and move the file to the QField folder Imported Projects.
  3. Open the project file from inside the QField app and collect data.
  4. Upload the project file back to the shared iCloud folder and replace the old project file.
  5. On the source device, download the new project file containing the added data and the changes made.

Share via AirDrop

A quick and easy way to exchange files back and forth is using AirDrop. The only requirement is that both source and target device have to be macOS and iOS respectively.

Workflow

  1. On the source device, right-click the file and select Share..., choose AirDrop, and then select the target device.
  2. On the target device, save the project directly to the QField directory Imported Projects.
  3. After your fieldwork, use AirDrop on the target device to transfer the project files back to the source device.

3. Importing projects and datasets

Apart from using QFieldCloud, QField can open projects and datasets in five ways:

QField import actions
QField import actions

On Android and iOS all of these actions are available by clicking on the "Import (+) button" located on the bottom-right corner of the project/dataset picker screen, which can be accessed by clicking on the "Open local files" button located in QField's welcome screen. For Windows, macOS, and Linux, since access to storage is not as limited, only the import from URL and import from WebDAV actions are made available.

Importare una cartella di progetto

When importing a project through the "Import project from folder" action you have to grant permission for QField to read the content of your folder on the device's storage.

Re-importing a given folder through the drop-down menu action will overwrite preexisting projects given an identical folder name. That will allow you to update their projects.

Note

Feature editing, addition, and deletion will be saved into the imported project's datasets, not in the original folder selected during the import process. See sections below on how to send/export edited projects and datasets.

Importare un progetto compresso

It is also possible to import compressed (zipped) projects into QField. QField will then decompress the file into its "Imported projects" location, from which users can open and interact with the project. This can greatly ease remote deployment of projects by being able to send a single file to users.

Importing individual datasets

The "Import dataset(s)" action allows you to select one or more datasets via your system file picker. After you selected the datasets, QField will copy those into the "Imported datasets" folder, from where you can then open and modify the content.

Note

Users will have to ensure that all sidecar files are selected when importing datasets (e.g. a Shapefile would require users to select the .shp, .shx, .dbf, .prj, and .cpg files).

Importare da un URL

When importing a project or individual dataset through the "Import URL" action, you will be asked to provide a URL string to a file. QField will subsequently fetch the content and save it into the "Imported projects" or "Imported datasets", respectively.

QField import URL dialog
QField import URL dialog

QField will consider a ZIP archive as a compressed project when one or more .qgs/.qgz project files are detected.

4. Exporting modified projects and datasets (Android and iOS)

Once you are done with your fieldwork, there are four ways to send and export the changed files back to the source device:

QField export actions
QField export actions

You can access these actions via the dropdown action menu inside the project/dataset picker which you can access by clicking on the "Open local files" button located in QField's welcome screen.

Esportare una cartella di progetto o un singolo set di dati

When choosing the "Export to folder" action, you will be asked to pick a location where the content will be copied to.

You can use this action to copy the content of modified projects or datasets into a folder on your device that can be accessed by third-party Synchronisation apps such as Syncthing. You can also directly copy content into cloud accounts of providers that support Android's Scoped Storage directory provider (eg. NextCloud).

Note

Esportare in una directory sovrasrive il contenuto esistente

Inviare una cartella di progetto compressa

The "Send compressed folder to" action compresses the content of a selected folder into a ZIP archive. You will be asked through which app the resulting ZIP archive should be sent through.

You can compress and send whole projects by selecting root folders in QField‘s "Imported projects" directory, as well as send selective folders within project folders (for instance, your photos only).

Sending an individual dataset (Android only)

You can select the "Send to" action for individual datasets, to directly send the changed datasets via third party apps such as Gmail, Drive, Dropbox, Nextcloud or your favorite messenger app.

You can also export the layers from a synchronized QFieldCloud project, either to your device or a preferred cloud provider. To do this, within your project:

  1. Direct to the folder icon with the wheel via the side "Dashboard" to open the project folder.

  2. Inside this project folder, you will find your project files. Offline layers will be stored in a file named "data.gpkg". You can also export your attached files (Photos, Audio, Video, etc).

  3. click on the 3-dotted menu (⋮) located on the right side of the file or folder.

  4. Choose between the actions "Send to..." or "Export to folder..." based on your preference and follow the prompts accordingly.

5. QField app directory

Beyond project-specific files stored in project folders, QField utilizes a dedicated App Directory to manage resources and configurations that are shared across all projects on a device. This centralized location allows you to provide custom fonts, basemaps, projection grids, and more on your device without needing to duplicate these files for every project.

Identification of local App Directory

  1. From the QField home screen, open a project.
  2. Open the side "Dashboard" (☰) via the button in the top-left corner.
  3. Select About QField from the 3-dotted menu (⋮).
  4. The application directory locations will be displayed at the bottom of the screen just below the App directories path (the paths differ depending on the operating system).

QField app directories
QField app directories

Common Locations

The path varies by operating system. Here are some common examples to help you find it:

  • Android: Internal Storage/Android/data/ch.opengis.qfield/files/QField.

  • iOS: Files App > On My iPhone/iPad > QField

  • Windows: C:\Users\<YourUsername>\AppData\Roaming\ch.opengis.qfield\QField

  • macOS: /Users/<YourUsername>/Library/Application Support/QField/QField

  • Linux: /home/<YourUsername>/.local/share/OPENGIS.ch/QField

The App Directory Structure

Directory Purpose and Contents
auth/ Stores authentication configurations (e.g., OAuth.xml certificates) required to access secured web services (WMS, WFS).
basemaps/ Contains shared basemap files, like COG or MBTiles layers.
fonts/ For custom font files (.ttf, .otf) to be used for labels or symbology across all projects.
logs/ Contains GNSS connection logs, which are valuable for debugging and troubleshooting positioning device issues.
plugins/ For custom QML plugins that extend QField's functionality.
proj/ Stores custom projection grids (e.g., .tiff files) for coordinate reference systems (CRS) that require additional transformation files.