qfieldName

qfieldName is a term used in the context of QField, a mobile data collection application designed to work with QGIS projects. It refers to the name of a data field as defined in the project's attribute table and used when designing forms and data bindings for field collection. In practice, qfieldName denotes the actual attribute name that a form control, script, or calculation references when data is captured on a device.

In a typical QField workflow, the project file includes a set of fields (attributes) such as date_collected, species_id, or location_name. Each of these fields has a field name—the qfieldName—that the app reads and writes. The qfieldName must correspond to an existing field in the layer, and bindings between UI elements and qfieldName ensure that user input updates the correct data attribute.

Guidelines: use descriptive, ASCII-only names; avoid spaces or special characters; prefer lowercase with underscores; keep names consistent across forms and calculations. If a field name changes in the underlying data, associated form bindings must be updated to reflect the new qfieldName to avoid data loss.

Examples: A form control labeled "Date collected" might bind to qfieldName date_collected; a dropdown for habitat type might bind to qfieldName habitat_type.

See also: QField, QGIS, attribute field, form binding, data schema.