Skip to content

Text

Adding or editing text is the most common method for inserting information within the forms. The Text Edit widget can be used for single-line or multiline text inputs for fields with Text (string) or varchar data types.

Widget
Preview in the mobile app
TextMergin Maps mobile app text field form
Multiline TextMergin Maps mobile app text field form

Example project available

Both single-line and multiline text options are used in this public project: Mergin Maps Project documentation/form-widgetsdocumentation/form-widgets. Download or clone it to see this setup.

Prefer a video? Here is a short tutorial about text widgets:

Text widget

The Text Edit widget is set by default for fields with text data type. For simple text input, you do not need to change it.

QGIS Text Edit Widget Type

In the mobile app, the basic text field looks like this:

Mergin Maps mobile app text field form

Multiline text

The Text Edit widget offers the option to store multiple lines within a single field.

  1. Right-click on a layer, select Properties and go to the Attributes form tab.
  2. In the list of Available Widgets select the field you want to work with (here: text-multiline)
  3. In the Widget Type tab:
    • Ensure that Text Edit is selected
    • Check the Multiline option ✔️
  4. Apply the changes. Don't forget to save and sync your project!

QGIS multiline text field setup

In the mobile app, the multiline text edit widget looks like this: Mergin Maps mobile app multiline text field form

TIP

Both QGIS and Mergin Maps mobile app support the use of HTML text fields. When setting up the multiline text widget, check also the HTML option ✔️.

HTML text fields can be used to include clickable links to, e.g., open a link in a browser or open a navigation app directly from the form in the mobile app.

Voice input

In the mobile app, the text can be entered manually or using voice-to-text (if your mobile device supports this feature).

Using voice to text in Mergin Maps mobile app