The original version of this document is located at https://docs.qfield.org/get-started/tutorials/get-started-qfc

Get started with QFieldCloud

What is QFieldCloud

QFieldCloud is the cloud service that allows seamless synchronization of your data between your mobile device for fieldwork and your desktop workstation.
You can manage teams, work in organizations, assign different editing permissions, and much more.

Register to QFieldCloud

🖥️ Project Manager

QFieldCloud Overview

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 getting started, familiarize yourself with the basic concepts of QFieldCloud.

Filtering Projects

🖥️ Project Manager

When managing a large number of cloud projects, you can refine your project list using the Filters dropdown button located next to the search bar.

The dropdown menu allows you to filter projects by three primary criteria:

• Ownership: (User accounts only):

  • My own projects: Displays only projects where your account is the primary owner.
  • Shared with me: Displays projects owned by collaborators or organizations where you have been granted access.
  • Project type:
  • Regular projects: Standard QGIS mapping projects created for field data collection.
  • Shared datasets: Centralized datasets stored in the dedicated shared_datasets project repository.
  • Template Projects: Projects locked for fieldworkers and used exclusively as project templates.

When any filter option is active, clicking the Clear button immediately resets all active filter parameters and restores the full project view.

Project Creation

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 clone an existing project.

Click here to read more about project creation

From QFieldCloud to QGIS Desktop

🖥️ Project Manager

In order to connect to QFieldCloud, you need the QFieldSync plugin in QGIS.
The following steps show how to install the plugin and synchronize your data to and from QFieldCloud.

Project Overview in QFieldSync

The project overview shows the projects that your account can access.
The screen contains the following elements:

• Current user underlined in blue
• Current user underlined in blue.
• The avatar on the top right leading to the sign-out page.
• A cloud button to create a new project.
• A refresh button on the right to update your project overview.
  

Newly registered users will see an empty table.
Double-click a project in the list to view and edit project properties.
Click on a project name in the list to view and edit project properties.

Project Status

The icons indicate the cloud and local status of each project.

• Local status:
  • {Width=”20px”} Indicates that only a remote cloud project exists.
  • {Width=”20px”} Indicates that the cloud project is also stored locally.
• Cloud status: Three color-coded statuses display the current state of your cloud project.
  A tooltip shows the status of each project.
  • Red Status: The project is invalid and not ready for field use.
    The status message on your QFieldCloud landing page provides details to address the issue.
  • Brown Status: The project is currently being updated or edited.
  • Green Status: The project is ready for field use.
    You can download the project to QField.

QField Project Settings

After installing the QFieldSync plugin, a new section appears under Project > Properties….
Access these settings from the QFieldSync toolbar {Width=”20px”} using the Settings icon.
You can access the settings from the QFieldSync toolbar {Width=”20px”} using the Settings icon.
Configure the following parameters in these settings:
You can adjust the following parameters in these settings:

• Define how project layers are treated in the cloud (see the QFieldSync Get Started Guide for details on Packaging Actions).
• Enable geofencing.
• Assign a digitizing log layer.
• Specify the active layer for editing after selecting a Map Theme.

We recommend using GeoPackages, especially when collaborating in teams.
See the Advanced Setup Guide for more information about vector formats.

Project Upload

Once configured, upload the project to QFieldCloud.

You can now view your project and files on your QFieldCloud project overview page.

From QFieldCloud to QField

When you are ready for fieldwork, set up QField on your mobile device.

Advanced Project Searching and Filtering

📱 Fieldwork

To manage a large number of projects, QField features a search-and-filter panel directly on the QFieldCloud projects screen.
The Filter button is located to the right of the project search bar.

1. Predefined Filter Presets

Quick preset buttons appear at the top of the filter panel (such as My Own Projects or {org_name}’s projects).
Tapping a preset populates the criteria form and automatically filters the underlying list.

2. Form-Based Filtering Criteria

Fine-tune your project queries by filling out fields in the filter pane:

• Search term: Selects every project title or description containing the provided term.
• Owner: Displays a list of unique project owners available to your account in an editable dropdown menu.
• Include public projects: Toggles community public projects on or off.

3. Power-User Search Syntax

The main search bar allows users to type advanced filter parameters directly using key-value syntax.
Key parameters are dynamically recognized and highlighted inside the text input box.

Supported syntax tokens include:

• owner:name — Filters the list to 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 into the search field isolates public projects matching the keyword “Forestry” owned by “My_Organization”.

Synchronization with QFieldCloud

After completing field data collection, synchronize your changes back to QFieldCloud.

Your changes are now available to all users with project access on the cloud.

Find more information in the Advanced QFieldCloud Setup Guide and QFieldCloud Technical Reference.