# QGIS Project Preparation

Project preparation is done in QGIS. For more information about loading layers, styling the data and creating map themes, visit QGIS Documentation QGIS documentation page (opens new window).

In addition, Mergin Maps Input 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.


Our tutorials can guide you through QGIS project preparation step by step.

In Creating a Project in QGIS you will learn how to create a project, add new layers and configure a basic form.

Further Project Customisation will show you how to style layers, add labels, customise the preview panel, define map themes and set up the project extent.

# Background layers

Various online and offline maps can be used as background layers for navigation during the field survey. You can find more information in Background Maps.

# Project extent

In Mergin Maps Input, there is an option to zoom to the project extent.

To set the project extent, navigate to Project > Properties. Select View Settings and check the Set Project Full Extent option. Here, either enter the coordinate extent of your project bounding box or use the map canvas extent.

QGIS set project extent

If not set, Mergin Maps Input zooms to all visible layers. This is not particularly convenient when you have a layer with a large/global extent (e.g. Open Street Map).

# Project settings

  • Ensure the paths are set to Relative in the General tab in Project Properties. All paths to the project data in Mergin Maps Input are relative to the project location.
    QGIS set relative paths
  • Define the QGIS Documentation layers capabilities (opens new window) in the Data Sources in Project Properties.
    • Identifiable layers can be queried in Mergin Maps Input. If you want to be able to search for attribute values in a layer, it needs to be identifiable and searchable.
    • read-only layers cannot be modified. If a vector layer is not intended to be used as a survey layer, set it as read-only.
    • non-spatial layers need to be set as searchable to enable browsing, searching, or editing.

QGIS Layer Capabilities

# Map themes

Map Themes make possible to switch between different background maps in Mergin Maps Input (e.g. cartography maps and aerial imagery)

# Photo quality

since Plugin 2022.3.2since Input App 1.5.1

The quality of photographs and pictures that are saved in the Mergin Maps project can be set up in the Mergin Maps tab in Project properties. When pictures are added using Mergin Maps Input (uploaded or taken with the camera), they will be resized accordingly.

By default, the quality is set to Original - the original pictures are stored. If you want to resize the pictures, you can choose from High, Medium, or Low quality. The EXIF metadata of the original files are kept.

Don't forget to save and sync your project!

Mergin Maps set photo quality

# Snapping

since Plugin 2022.5since Input App 1.6.0

If you want to use snapping in Mergin Maps Input during the field survey, you need to set it up in the Mergin Maps tab in Project properties.
QGIS set snapping in Mergin Maps

The snapping options are:

  • No snapping - snapping is not enabled (default)
  • Basic snapping - features are snapped to the vertices and segments of vector features in the project
  • Follow QGIS snapping - uses the snapping preferences defined in the Mergin Maps project in QGIS


How to Set Up Snapping for Mergin Maps Input contains detailed steps that may help you with the snapping setup.

# Survey layers

Vector layers can be used as survey layers in Mergin Maps Input. You can apply styles and set up the forms to make your field survey easier.

# Layer symbology

The same symbology as defined in the QGIS project will be used in Mergin Maps Input. However, Mergin Maps Input does not include all the SVG markers that are available within QGIS. Therefore, if you are using SVG markers for your layer styling, ensure those are copied to the project folder.

# Forms

During the field survey, it is often necessary to fill out some attributes in the form to record the properties of surveyed features. Forms can make the survey easier, consistent and more effective. Detailed description of form widgets and form configuration can be found in Setting Up Form Widgets and Advanced Form Configuration

# Settings for Mergin Maps Input preview panel

What appears in the Mergin Maps Input preview panel can be defined in the Display tab in Layer Properties:

  • Display Name: a field name or an expression.
  • HTML Map Tip: the content of the preview panel. While QGIS always interprets the content of map tip as being HTML, Mergin Maps Input extends the syntax to allow two more modes: field values and images. If the map tip is not specified, Mergin Maps Input will try to use the first three fields and show their attribute values.

QGIS layer properties display settings


Sample map tip content that will show render as HTML page:

<p><strong>Notes:</strong>[% "notes" %]</p>

If the map tip does not contain any special marker, it is assumed that the map tip is HTML content. Only a limited subset of HTML is supported - see Qt documentation (opens new window)

# Field values

Sample map tip content that will show "description" and "time" field values:

# fields

If the map tip content has # fields marker on the first line, the following lines will be understood as field names that should be listed in the preview. At most three fields will be shown. Expressions are not allowed.

# Image

Sample map tip content that will cause an image to be show specified by file path in field "image_1" (containing path relative to the project folder):

# image
file:///[%@project_folder%]/[% "image_1" %]

If the map tip has # image marker on the first line, the following line is understood as the URL for the image. It can be a regular file on the file system, but it could be even a remote image from network. Expressions embedded in the image URL will be evaluated (enclosed in [% 1+1 %]).

Preview panel in Input based on Display settings in QGIS