# File 1 Formatting Table
>Last modified: 24 Jul 2026
<div style="background-color: rgba(0, 178, 169, 0.3); padding: 5px; border-radius: 5px;"><strong>Variable names, formats and values to include in File 1s.</strong></div>
<br>

<big>**Table 3: File 1 formatting specification (multiple rows per individual)**</big>

<aside class="admonition note"><p class="admonition-title">Use the exact Field Names in the table below. Field Names <strong>MUST</strong> have underscores between words.</p></aside>

| <small>Order | <small>Field Name | <small>Data Type | <small>Description & values | 
|---:|---|---|---|
| 1<br><br><br><br><br> | <small>STUDY_ID<br><br><br><br><br> | varchar(50)<br><br><br><br><br> | Unique per participant<br>Relate to the same person when used in File 2<br>Same for each row of data for each individual<br>Same for each individual across subsequent File 1s. <br><details><summary>Explanation</summary>Unique LPS-generated identifier (also to feature in 'File 2' attribute data file).|
| 2<br><br><br> | <small>ROW_STATUS<br><br><br> | char(1)<br><br><br> | C = Current<br>H = Historical/Alternative<br><details><summary>Explanation</summary>Indicates whether the row of information per participant is the 'current' row of information or a row containing historical or alternative values. | 
| 3<br><br><br><br><br><br><br><br><br><br><br> | <small>NHS_NUMBER<br><br><br><br><br><br><br><br><br><br><br> | varchar(10)<br><br><br><br><br><br><br><br><br><br><br> | Preferrably new NHS ID format, but old NHS ID is preferred to no NHS ID.<br>Where LPS have 'Community Health Index' (CHI) number leave this null and instead populate NHS_S_Study_Number (field 22) with CHI.<br>Include each known NHS ID as a separate row of information. The NHS ID which is likely to be most accurate should be included in the 'current' row. Leave null if not known or if inclusion is not permitted by your DSA. <details><summary>Explanation</summary> NHS number, formatted with no spaces. This should only be provided if the LPS’s DSA with NHSE permits onward sharing of NHS IDs. See [Appendix B](../appendix/b_nhs_dsas.md) for more information. |  
| 4<br><br> | <small>SURNAME<br><br> | varchar(255)<br><br> | Provide current name in 'current' row<br>Provide previous name(s) in separate rows of historical data |
| 5<br><br> | <small>FORENAME<br><br> | varchar(255)<br><br> | Provide current name in 'current' row<br>Provide previous or alternative forename(s) in separate rows of historical data |
| 6 | <small>MIDDLENAMES | varchar(255) | Space delimited middle name(s) | 
| 7<br><br><br><br> | <small>ADDRESS_1<br><br><br><br> | varchar(255)<br><br><br><br> | First line of address. <br>Provide current value in 'current' row <br>Provide previous address data (all address fields, postcodes and start/end dates) as separate rows of historical data |
| 8 | <small>ADDRESS_2 | varchar(255) | Second line of address |
| 9 | <small>ADDRESS_3 | varchar(255) | Third line of address (where available) |
| 10 | <small>ADDRESS_4 | varchar(255) | Fourth line of address (where available) |
| 11 | <small>ADDRESS_5 | varchar(255) | Fifth line of address (where available) | 
| 12<br><br><br><br> | <small>POSTCODE<br><br><br><br> | varchar(8)<br><br><br><br> | Postcode, where possible in formal space separated format, i.e.<br>4 & 3 = "YYYY ZZZ" <br>3 & 3 = "YYY ZZZ"<br>2 & 3 = "YY ZZZ"  | 
| 13<br><br><br><br> | <small>ADDRESS_START<br>_DATE<br><br><br> | varchar(10)<br>dd/mm/yyyy<br><br><br> | If not known leave as null. <br>For partial information use '00' where not known. E.g., if month and year are known, include '00' for day, e.g. 00/01/1988.<br><details><summary>Explanation</summary>The (best available estimate) date the participant moved into this addresss |
| 14<br><br><br><br><br><br> | <small>ADDRESS_END<br>_DATE<br><br><br><br><br> | varchar(10)<br>dd/mm/yyyy<br><br><br><br><br> | Leave as null if current address <br>For partial information use '00' where not known. E.g., if month and year are known, include '00' for day, e.g. 00/01/1988. <br>Use 00/00/0000 where you do not know the date but do know it is not the current address. <br><details><summary>Explanation</summary>The (best available estimate) date the participant left this addresss |
| 15<br><br><br> | <small>DATE_OF_BIRTH<br><br><br> | varchar(10)<br>dd/mm/yyyy<br><br> | If not known leave as null <br>For partial informaton, use '01' where the day is not known. E.g., if only month and year are known, include '01' for day, e.g. 01/05/1988. |
| 16<br><br> | <small>GENDER_CD<br><br> | char(1)<br><br> | 1=male, 2=female, 7=other, 8=unspecified, 9=unknown<br><details><summary>Explanation</summary> Current gender (where recorded separately from 'sex') |
| 17<br><br> | <small>CREATE_DATE<br><br> | varchar(10)<br>dd/mm/yyyy<br> | The date on which the LPS created the file <br>Do not include 'time' |
| 18<br><br><br><br> | <small>UKLLC_STATUS<br><br><br><br> | char(1)<br><br><br><br> | An overall permission flag, which is set to 1, unless a participant should be withdrawn, where it is set to 0 to stop the future use of the participant’s data in the UK LLC TRE and to stop any flows of linked records. <br><details><summary>Explanation</summary>This indicates if a participant is considered active in UK LLC. In an LPS’s first File 1, ALL participants must be active. In subsequent iterations, the flag indicates when a participant has withdrawn consent. | 
| 19<br><br><br><br>| NHS_E_Linkage<br>_Permission<br><br><br> | char(1)<br><br><br><br> | 1=included<br>0-identifiers should not be forwarded for linkage to NHS England or other English NHS sources.<br><details><summary>Explanation</summary>If value is set to '1', participants are linked with their English health records (where available).<br>For data linkage to NHS England, there are two data flows. There is one flow for registry data (e.g. demographics, mortality, cancer) and one flow for all other health records data. Both data flows are controlled by the same permission flag (nhs_e_linkage_permission) in the File 1 sent to DHCW.</details> | 
| 20<br><br><br> | NHS_Digital_Study<br>_Number<br><br> | varchar(50)<br><br><br> | Participant’s NHS England flagging ID (MR Study Number)<br>9=unknown.<br><details><summary>Explanation</summary>This is a study-level identifier assigned by NHS England (previously NHS Digital) where a study has previously linked to NHS England data.</details> |
| 21<br><br><br><br><br><br> | NHS_S_Linkage<br>_Permission<br><br><br><br><br> | char(1)<br><br><br><br><br><br> | 1=included. <br>0-identifiers should not be forwarded for linkage to Public Health Scotland (PHS).<br><b>Additional governance is required for linkage to Scottish Health records.</b> See 'Explanation' for details.<br><details><summary>Explanation</summary>If value is set to '1', participants are linked with their Scottish health records (once these linkages are established)<br><br><b>Additional governance</b><br>The NHS Scotland Public Benefit and Privacy Panel (PBPP) for Health and Social Care must undertake its own assessment of LPS's consent and fair processing materials as consent is the only legal basis for linkage to Scottish health records.<br>The PBPP requires confirmation that a <b>substantial number of LPS participants were recruited from or currently live in Scotland</b>. If your LPS is interested in linkage to Scottish health records, please contact [info@ukllc.ac.uk](mailto:info@ukllc.ac.uk) .<br>If your LPS has not been assessed by the PBPP, please ensure the NHS_S_Linkage permission flag is set to '0'. </details> | 
| 22<br><br><br> | NHS_S_Study<br>_Number<br><br> | varchar(50)<br><br><br> | Participant’s PHS ID<br>9 = unknown.<br><details><summary>Explanation</summary>Unique identifier assigned by Public Health Scotland to a research/data access project | 
| 23<br><br><br> | NHS_W_Linkage<br>_Permission<br><br> | char(1)<br><br><br> | 1=included<br>0=identifiers should not be forwarded for linkage to NHS DHCW.<br><details><summary>Explanation</summary>If value is set to '1', participants are linked with their Welsh health records (where available) | 
| 24<br><br><br> | NHS_NI_Linkage<br>_Permission<br><br> | char(1)<br><br><br> | 1=included<br>0=identifiers should not be forwarded for linkage to the HSCNI.<br><details><summary>Explanation</summary>If value is set to '1', participants will be linked with their Northern Irish health records (once these linkages are established) | 
| 25<br><br><br> | NHS_NI_Study<br>_Number<br><br> | varchar(50)<br><br><br> | Participant’s HSCNI BDS ID<br>9=unknown.<br><details><summary>Explanation</summary>Unique identifier assigned to each individual in Northern Ireland (NI) registered within the Health and Social Care system | 
| 26<br><br><br><br> | Geocoding_<br>Permission<br><br><br> | char(1)<br><br><br><br> | 2=included for full address<br>1=included for postcode only<br>0=objects and data should not be forwarded for geocoding to Leicester.<br><details><summary>Explanation</summary>Indicates whether address data can be geocoded to property, postcode level, or not at all.</details> |
| 27<br><br><br> | Small_Area<br>_Permission<br><br> | char(1)<br><br><br> | 1=included for LSOA/DZ/SOA or higher<br>0=objects and data should not be forwarded for linkage to SeRP.<br><details><summary>Explanation</summary>Place-based information can be linked using encrypted Lower Super Output Area (LSOA)/Data Zone (DZ)/ Super Output Area (SOA) and higher-level indicators originating from linked sources.</details> |
| 28<br><br><br> | Environment<br>_Permission<br><br> | char(1)<br><br><br> | 1= included<br>0= objects and data should not be forwarded for linkage to Leicester/SeRP.<br><details><summary>Explanation</summary>UK LLC can link sources of natural and built environment data subject to prior notification via Vanguard/email.
| 29<br><br><br> | Property_Level<br>_Permission<br><br> | char(1)<br><br><br> | 1= included<br>0= objects and data should not be forwarded for linkage to Leicester/SeRP.<br><details><summary>Explanation</summary>UK LLC can link sources of property-level data subject to prior notification via Vanguard/email. |
| 30<br><br><br> | Multiple_Birth<br><br><br> | char(1)<br><br><br> | 0=Singleton<br>1=Multiple birth<br>9=Not known/Missing | |
| 31<br><br><br><br><br> | National_Opt_Out<br><br><br><br><br> | char(1)<br><br><br><br><br> | If it is a consented cohort, set this to 0.<br>0=National Opt Out not applied (set as 0 where explicit consent is in place)<br>1=National Opt Out is applied (set as 1 where there is no explicit consent in place and <a href="https://www.hra.nhs.uk/about-us/committees-and-services/confidentiality-advisory-group/confidential-patient-information-and-regulations/" target="_blank" rel="noopener noreferrer"><b>Section 251</b></a> is used).<br><details><summary>Explanation</summary>This is where LPS using an opt out approach to linkage permissions in England and Wales need to apply the National Opt Out. | 
| 32<br><br><br> | DFE_Linkage<br>_Permission<br><br> | char(1)<br><br><br> | 1=included<br>0=identifers should not be included in DFE linkage via ONS<br><details><summary>Explanation</summary>Participants' permissions to link to education records via the Department of Education. | 
| 33<br><br><br> | DWP_Linkage<br>_Permission<br><br> | char(1)<br><br><br> | 1=included<br>0=identifers should not be included in DWP linkage via ONS<br><details><summary>Explanation</summary>Participants' permissions to link to employment records via the Department for Work & Pensions. | 
| 34<br><br><br> | HMRC_Linkage<br>_Permission<br><br> | char(1)<br><br><br> | 1=included<br>0=identifers should not be included in HMRC linkage via ONS<br><details><summary>Explanation</summary>Participants' permissions to link to tax records via His Majesty’s Revenue & Customs (HMRC). | 




