QFieldCloud is the cloud service that allows smoothless synchronization of your data between your mobile device for fieldwork and your desktop working station.
You can further manage teams, work in organizations, assign different editing permissions and much more.
Once registered, your personal QFieldCloud landing page will show all the projects that you have access to in the center of the window.
In case that you have many projects, you can search in the search bar at the top of the page.
It is also possible to create a new empty project from this menu.
All further configuration of that project, however, needs to be done inside QGIS.
Under your profile name, you are able to edit and manage your account details and get an overview of what organizations you are a member of, as well as what collaborations you have.
Finally, if you have subscribed to a plan through QFieldCloud, you can manage it from here.
Before you get started, we recommend to familiarize yourself with the basic concepts of QFieldCloud.
Tip
In the project overview page, the two names indicate the "Owner" of the project and the "Name" of the project.
There are several ways to create and initialize a new project in QFieldCloud depending on your workflow. You can convert an existing QGIS project, start from a blank template on the web, or even clone an existing project.
In order to connect to QFieldCloud, you need the QFieldSync plugin in QGIS. The next steps show you how you can install and synchronize your data to and from QFieldCloud.
Workflow
Open the QGIS plugin manager by going to Plugins > Manage and Install Plugins...
Under "All", find QFieldSync in the list and install the latest version by clicking the "Install Plugin" button.
Successful installation
After successful installation, a new toolbar appears:
Toolbar
Click the cloud icon in the QFieldSync toolbar and a new login screen will appear:
Enter your credentials previously created during account registration.
Warning
If you use a password in QGIS for the first time, it will ask you to set a master password that manages all the other passwords used in QGIS. More information about the master password here: QGIS documentation
Le icone mostrano lo status cloud e locale dei differenti progetti.
Local status:
indicates that there is only a remote cloud project existing.
indicates that the cloud project is also locally stored.
Cloud status: There are three different types of status indicated by a color which show the current status of your cloud project.
The status of each project is shown with a tooltip.
Red Status: The project is invalid and is not ready for use in the field.
There are multiple reasons for this and the status message on your QFieldCloud landing page is the first step to address the issue.
Brown Status: The project is currently being updated or edited.
Green Status: The project is ready to be used in the field.
You can download the project down to QField.
When you have installed the QFieldSync Plugin, a new section will appear under Project > Properties.
It is also available in the QFieldSync toolbar through the Settings icon.
Under these settings you can configure the following:
How your project layers should be treated in the cloud. See Get Started guide for QFieldSync to get more details on the different "Packaging Actions".
Specify the layer that will be active for editing after selecting a Map Theme
We recommend to work with GeoPackages, especially when working in teams. See the advanced setup guide for more information about vector formats.
Important
If you use experimental data sources without a primary key field (e.g. Shapefiles, GeoJSON etc), you must have a lowercase fid field that will be used as a primary key that uniquely identifies each feature.
Once configured, the project can be uploaded to QFieldCloud.
Workflow
Press the cloud icon with the arrows via the QFieldSync toolbar.
Here you have to decide what you prefer:
The Local file: This will replace your cloud file with a new version of the project.
Note: When working with GeoPackages, the current version of the file in the cloud will be replaced with the local version.
The Cloud file: This will amend your local datasets and replace your project file with the current one.
Sincronizza
Now you should see your project and files on your project overview page on QFieldCloud
At the top of the filter panel is a quick preset buttons (such as My Own Projects, {org_name}'s projects). Tapping any preset instantly populates the criteria form and automatically filters the underlying list.
You can fine-tune your project queries by filling out distinct fields in the filter pane:
Search term: Every project title or description that contains the provided term(s) will be selected.
Owner: An editable dropdown combobox that automatically displays a list of unique project owners available to your account.
Include public projects: A toggle switch that lets you pull in or hide community public projects.
Note
Community projects are projects that are marked as public by any project owner.
Public projects are available to view to every user of QFieldCloud.
Edits, however, can only be made in case that you as a project owner adds them as collaborators to your project.
For this, you do not need to have an organization account.
The filter panel acts as visual "training wheels," but the main search bar is built for power users. Advanced filter parameters can be typed directly into the search bar using a dedicated key-value syntax.
Key parameters are dynamically recognized and highlighted in a distinct accent color directly inside the text input box.
Supported syntax tokens include:
owner:name — Filters the list to only show projects belonging to a specific user or organization account name.
include:public — Forces public projects to be included in the query evaluation.
Example Query: Typing owner:My_Organization include:public Forestry directly into the search field instantly isolates public projects matching the keyword "Forestry" owned by "My_Organization".
After you are done with data collection, you will need to synchronize your changes back to QFieldCloud.
Workflow
Open the Side Dashboard in QField.
Click on the cloud icon (a badge will indicate how many local changes you have made).
Cloud button
Upload local changes: Sends your edits and attachments to the cloud without downloading project updates from other collaborators.
This is fast and saves internet bandwidth.
Synchronize project: Uploads your edits, then downloads the latest project from QFieldCloud so everything is completely up to date.
Upload history: Tap this button below the main actions to view a detailed log of your past uploads, including timestamps and their current statuses (e.g., Applied, Pending, Conflict, Error).
Danger zone: Tap this button to if you wish to revert previous actions or restore the current version of the cloud project.
You can Discard local changes (which removes all your local edits that have not yet been uploaded) or Reset project (which re-downloads the cloud version if your local copy becomes corrupted).
Choose the appropriate action card for your data:
Le tue modifiche sono adesso disponibili a chiunque abbia accesso al tuo progetto sul cloud.
in the QFieldSync toolbar and a new login screen will appear:
indicates that there is only a remote cloud project existing.
indicates that the cloud project is also locally stored.
through the Settings icon.
Under these settings you can configure the following:
