How to Create a Research Data Dictionary
A data dictionary is a document that defines every variable in your dataset: its name, label, type, allowed values, units and how missing data are coded. Creating it before data collection prevents inconsistent entries and makes analysis and sharing far easier.
What to define for each variable
| Field | Example |
|---|---|
| Variable name | age_years |
| Label | Age at admission |
| Type | Integer, continuous, categorical, date, text |
| Units or categories | years; 1 = female, 2 = male, 3 = other |
| Allowed range | 0 to 120 |
| Missing code | blank = not recorded; 99 = not applicable (state which) |
| Source | Admission record |
| Required? | Yes/No |
| Notes | How derived or checked |
How to create one
- List the variables needed for your objectives, exposures, outcomes and confounders.
- Choose short, consistent names without spaces.
- Define each variable precisely, including time windows (for example "30-day mortality from index admission").
- Specify codes for categories and for missing or not applicable.
- Add validation rules in your data collection tool (dropdowns, ranges).
- Pilot on a few records and revise.
- Keep a version history and lock the dictionary when data collection starts.
MRN's free data collection sheet includes a data dictionary sheet.
Illustrative example
Invented for teaching. Two data collectors code "diabetes" differently, one by chart diagnosis and the other by HbA1c above a threshold. A data dictionary that defines "diabetes = documented physician diagnosis in the problem list before admission" prevents inconsistent entries.
Common pitfalls
- Changing definitions mid-study without recording it.
- Using free text where a coded field would do.
- Collecting identifiers that are not needed.
Key takeaways
- Define every variable before collecting.
- Use consistent codes and keep a record of changes.
References and further reading
- Hulley SB, Cummings SR, Browner WS, Grady D, Newman TB. Designing Clinical Research. 4th ed. Lippincott Williams & Wilkins; 2013. Link
- Sterne JAC, White IR, Carlin JB, et al. Multiple imputation for missing data in epidemiological and clinical research: potential and pitfalls. BMJ. 2009;338:b2393. doi:10.1136/bmj.b2393
Related reading
This page is general educational information about research methods. It is not medical, legal or regulatory advice; follow your institution's ethics board and your target journal's instructions.
