Multilingual Project Support

Multilingual Project Support

The original version of this document is located at https://docs.qfield.org/how-to/advanced-how-tos/multilingual-projects

Multilingual Project Support in QField

QField supports for Project Localization, meaning that a single QGIS project file supports multiple lanaguages if the according configuration has been applied.

This allows the field staff to see the layer names, field aliases, and value maps in the device’s local language without needing separate project files.

How it works

The system relies on Qt Translation files (.qm) stored alongside the QGIS project.
When QField opens a project, it checks the device’s language settings.
If a matching translation file is found, QField automatically translates the project interface.

Example:

You have a project named Beekeeping.qgs (in English).

  • User A has a phone with an English operating system.
    As a title, when opening the project the user will see “Bee Species” as a title.
  • User B has a phone with a German operating system.
    When oppening the same project file (Beekeeping.qgs).
    QField will detect the local language, accesses the German translation file, and correspondingly displays “Bienenarten” as title instead.

Key Features

  • Automatic Language Detection: QField respects the language defined in QField’s system settings or the device’s Operating System locale.
    Languages do not need to manually switched.
  • Cleaner File Browser: QField hides the “translated” sidecar project files (e.g., Beekeeping_de.qgs) from the file selector.
    Users simply select the main project file, and QField handles the translation in the background.
  • Cloud Support: This feature is fully compatible with QFieldCloud projects.
  • Metadata Support: This is supported for translating project and layer metadata (titles, abstracts, etc.), useful for identifying datasets in the field.

Setting up Multilingual Projects

To enable this in QField, you must prepare your project in QGIS.
The workflow is identical to the standard QGIS localization process.
(for a more detailed step-by-step instructions check the following blog QGIS speaks a lot of languages).

Workflow

🖥️ QGIS Setup

  1. Open your project in QGIS.
  2. Go to Project Properties > General.
  3. Under Generate Transaction Source File (TS), select your project’s source language (e.g., English).
  4. Click Generate TS File. This creates a .ts (XML) file in your project folder containing all translatable strings (Layer names, Field Aliases, Value Relations, etc.).

🖥️ 2. Translation

  1. Open the .ts file using Qt Linguist (standard Qt utility) or a web platform like Transifex.
  2. Translate the strings (e.g., source: “Beekeeper”, translation: “Imker”).

🖥️ 3. Compilation

  1. Once translated, “Release” the file in Qt Linguist to generate a .qm file (binary translation file).
  2. Crucial Naming Convention: The .qm file must be named exactly matching your project filename with the language code appended.
    • Project: citybees.qgs
    • German Translation: citybees_de.qm
    • French Translation: citybees_fr.qm

🖥️ 4. Transfer to QField

  1. Copy the .qgs (or .qgz) file and the associated .qm files to the device (or upload them to QFieldCloud).

Notes

  • Sidecar Files: In QGIS Desktop, opening a translated project often generates a temporary file (e.g., citybees_de.qgs). QField is programmed to ignore these files in the browser to prevent users from opening the wrong file. Always open the source project.
  • Translatable Elements:
    • Layer Names & Group Names
    • Field Aliases (Note: Field Names remain unchanged to preserve data integrity; only Aliases are translated)
    • Value Relation Widgets (Content)
    • Project Metadata

    • Related Articles

    • Support the QField Project

      The original version of this document is located at https://docs.qfield.org/get-started/contribute Support the QField Project QField is an open source project. It is free to share, use and modify and it will stay like that. We are very happy if this ...

    • Portable project

      The original version of this document is located at https://docs.qfield.org/how-to/advanced-how-tos/movable-project Portable project To manually synchronize your QGIS project, you will need a portable version of your QGIS project file (.qgs, .qgz). ...

    • Project selection

      The original version of this document is located at https://docs.qfield.org/how-to/general/projects Project selection QField has a file selector that allows to open a project from the device locally. To open files from the cloud see QFieldCloud. Note ...

    • Create new Project from in QField

      The original version of this document is located at https://docs.qfield.org/how-to/project-setup/create-project Create a new project in QField It is possible to create a simple project to collect notes with or without attachments and tracking ...

    • My first project using QGIS and QField with QFieldCloud

      The original version of this document is located at https://docs.qfield.org/get-started/tutorials/my-first-project My first project This page will go through a step by step example of how to prepare a simple QField project containing a points layer, ...