Variables

Variables

The original version of this document is located at https://docs.qfield.org/how-to/variables

Variables

QField allows user to add and edit expression variables.
These can be used for a wide range of applications, including data-defined symbology, setting default field values, controlling print layout and application behavior, and much more.
See the relevant QGIS documentation for more information.

QField supports two main types of variables:

  • Project Variables: Project-bound variables defined within the project file.
  • Global Variables: Application-wide global variables with a set of read-only variables matching those found in QGIS.

Project Variables

Project variables are defined and managed directly within your QGIS project.
They allow you to add custom variables that are only relevant in the context of a specific project.
QField users can edit those variables, with modified values remembered across sessions.

Global Variables

New global variables can be added or modified once and will be injected into all projects opened in QField across sessions.
Global variables can be used to add a unique identifier across a fleet of QField devices for example, or determine the language for a given QField user.
Since they are not bound to specific projects and are defined locally, they make for a great way to customize experience for multiple users sharing the same projects.

Variable Management in QField

Variables are managed directly on your device and are accessible in all available QField projects.
When you access the variables list in QField ( Settings > Variables ), you will find a consolidated and organized view of all available variables.

Variable configuration

📱 Fieldwork

To configure a device-specific variable, follow these steps:

  1. Open Settings in QField.
  2. Navigate to the Variables tab.

Here you will see a list of all variables currently applicable to your project.
To add a new variable:

  1. Click on Add a new variable at the bottom of the variable list.
  2. Enter the name and value for your new variable.

Configuration of editable variables in addition to the pre-defined system variables.

    • Related Articles

    • Expression Variables

      The original version of this document is located at https://docs.qfield.org/reference/expression_variables Expression Variables in QField QField supports various expression variables that can be used in forms, expressions, and field defaults. These ...

    • Secrets

      The original version of this document is located at https://docs.qfield.org/reference/qfieldcloud/secrets Secrets Secrets are Project settings that are securely stored in an encrypted way. Jobs will automatically have access to project’s secrets. ...

    • Positioning (GNSS)

      The original version of this document is located at https://docs.qfield.org/how-to/gnss Positioning (GNSS) QField can make use of the internal GNSS (Global Navigation Satellite System, like GPS, GLONASS, Galileo or Beidou). QField can also connect to ...

    • PostgreSQL service

      The original version of this document is located at https://docs.qfield.org/how-to/pg-service PostgreSQL service A pg_service.conf file allows to use an named alias for a PostgreSQL server connection. Instead of storing hostname, port, database name ...

    • Map Decorations

      The original version of this document is located at https://docs.qfield.org/how-to/decorations Map Decorations Map decorations are a good way for adding dynamic information directly onto your map view in QField. Elements, such as titles, grids, and ...