Skip to content

Adding codelists to a project

Adding a codelist🔗

Take a look at the codelists/codelist.txt file in the repo, and note the structure of the existing example codelists that shipped with the research template:


If you want a codelist from OpenCodelists, then you need to put it in this format in the codelist.txt file.

For example:



Adding a CSV to a file🔗

Download the new codelists into the codelist/ folder using the opensafely program by running

opensafely codelists update

Beware that in Windows, if one or more of these codelist files is open then this command won't be able to run; close them first.

You will need to add and commit these changes and push to GitHub. If you don't, or a newer version is available than that committed, the automated tests will fail with an error message.