---
id: "variable_name"
kind: "datatype"
status: "draft"
is_pii: false
name: "Variable name (name of a data field)"
regexp: "^[A-Za-z_@#$][A-Za-z0-9_.@#$]{0,127}$"
categories: ["common"]
langs: ["common"]
quality: 90
url: "https://registry.apicrafter.io/datatype/variable_name"
---

# Variable name (name of a data field) (`variable_name`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Name of a variable or field of a dataset as a codebook, a data dictionary, a variable list or a table in the long format lists it: a short token without spaces such as f1, SEX_2016, Q28_1 or v2x_polyarchy, in the spelling of the data file. The variable info exports of Dataverse (variable, value, label) and DDI codebooks give one row per variable or per value label. Not the label that describes the variable (description).

- Personal data (PII): no
- Categories: Common (common)
- Countries: global
- Languages: Common to most languages (common)
- Classification: identifier

## Detection

Regular expression (Python `re`):

```
^[A-Za-z_@#$][A-Za-z0-9_.@#$]{0,127}$
```

## Examples

- `SEX_2016` — Sex of the respondent (Social Survey Austria 2016)
- `f11_10` — Item 10 of question 11
- `v2x_polyarchy` — Electoral democracy index of V-Dem
- `Q28_1` — First item of question 28
- `Wie zufrieden sind Sie?` (invalid example) — A variable label, not a name

## Metacrafter rules

2 rules: 1 match the field name, 1 match values.

- `variablenamebyname` (field, `common/survey.yaml`)
- `variablenamevalue` (data, `common/survey.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- de: Variablenname

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Data_dictionary>

## Quality

Score 90/100. Missing: mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/variable_name.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/common/variable_name.yaml>
