submit-social-housing-lettings-and-sales-data/spec/fixtures/files/2026_27_lettings_bulk_upload.csv

1	Section	Setting up this lettings log															Property information																					Tenancy information					Household characteristics																																	Household needs																					Household situation																					Income, benefits and outgoings
2	Question	Which organisation owns this property?	Which organisation manages this letting?	What is the CORE username of the account this letting log should be assigned to?	What is the needs type?	What scheme does this letting belong to?	Which location is this letting for?	Is this letting a renewal of social housing to the same tenant in the same property?	What is the tenancy start date? - day DD	What is the tenancy start date? - month MM	What is the tenancy start date? - year YY	What is the rent type?	Which 'Other' type of Intermediate Rent is this letting?	What is the tenant code?	What is the property reference?	Has the tenant seen or been given access to the MHCLG privacy notice?	What is the reason for the property being vacant?	What type was the property most recently let as?	If known, provide this property’s UPRN	Address Line 1	Address Line 2	Town or city	County	Part 1 of the property's postcode	Part 2 of the property's postcode	What is the property's local authority?	What type of unit is the property?	Which type of building is the property?	Is the property built or adapted to wheelchair-user standards?	How many bedrooms does the property have?	What is the void date? - day DD	What is the void date? - month MM	What is the void date? - year YY	What date were any major repairs completed on? - day DD	What date were any major repairs completed on? - month MM	What date were any major repairs completed on? - year YY	Is this property older people's housing?	Is this a joint tenancy?	Is this a starter tenancy?	What is the type of tenancy?	If 'Other', what is the type of tenancy?	What is the length of the fixed-term tenancy to the nearest year?	What is the lead tenant’s age?	Which of these best describes the lead tenant’s gender identity?	Which of these best describes the lead tenant's ethnic background?	What is the lead tenant’s nationality?	Which of these best describes the lead tenant’s working situation?	Is person 2 the partner of the lead tenant?	What is person 2's age?	Which of these best describes person 2's gender identity?	Which of these best describes person 2's working situation?	Is person 3 the partner of the lead tenant?	What is person 3's age?	Which of these best describes person 3's gender identity?	Which of these best describes person 3's working situation?	Is person 4 the partner of the lead tenant?	What is person 4's age?	Which of these best describes person 4's gender identity?	Which of these best describes person 4's working situation?	Is person 5 the partner of the lead tenant?	What is person 5's age?	Which of these best describes person 5's gender identity?	Which of these best describes person 5's working situation?	Is person 6 the partner of the lead tenant?	What is person 6's age?	Which of these best describes person 6's gender identity?	Which of these best describes person 6's working situation?	Is person 7 the partner of the lead tenant?	What is person 7's age?	Which of these best describes person 7's gender identity?	Which of these best describes person 7's working situation?	Is person 8 the partner of the lead tenant?	What is person 8's age?	Which of these best describes person 8's gender identity?	Which of these best describes person 8's working situation?	Does anybody in the household have links to the UK armed forces?	Is this person still serving in the UK armed forces?	Was this person seriously injured or ill as a result of serving in the UK armed forces?	Is anybody in the household pregnant?	Disabled access needs a) Fully wheelchair-accessible housing	Disabled access needs b) Wheelchair access to essential rooms	Disabled access needs c) Level access housing	Disabled access needs f) Other disabled access needs	Disabled access needs g) No disabled access needs	Disabled access needs h) Don’t know	Does anybody in the household have a physical or mental health condition (or other illness) expected to last 12 months or more?	Does this person's condition affect their dexterity?	Does this person's condition affect their learning or understanding or concentrating?	Does this person's condition affect their hearing?	Does this person's condition affect their memory?	Does this person's condition affect their mental health?	Does this person's condition affect their mobility?	Does this person's condition affect them socially or behaviourally?	Does this person's condition affect their stamina or breathing or fatigue?	Does this person's condition affect their vision?	Does this person's condition affect them in another way?	How long has the household continuously lived in the local authority area of the new letting?	How long has the household been on the local authority housing register (or waiting list) for the area of the new letting?	What is the tenant’s main reason for the household leaving their last settled home?	If 'Other', what was the main reason for leaving their last settled home?	Where was the household immediately before this letting?	Did the household experience homelessness immediately before this letting?	Do you know the postcode of the household's last settled home?	Part 1 of postcode of last settled home	Part 2 of postcode of last settled home	What is the local authority of the household's last settled home?	Was the household given 'reasonable preference' by the local authority?	Reasonable preference reason They were homeless or about to lose their home (within 56 days)	Reasonable preference reason They were living in unsanitary, overcrowded or unsatisfactory housing	Reasonable preference reason They needed to move due to medical and welfare reasons (including disability)	Reasonable preference reason They needed to move to avoid hardship to themselves or others	Reasonable preference reason Don't know	How was this letting allocated? Choice based Lettings (CBL)	How was this letting allocated? Common Allocations Policy (CAP)	How was this letting allocated? Common Housing Register (CHR)	How was this letting allocated? Accessible Housing Register	What was the source of referral for this letting?	Do you know the household's combined total income after tax?	How often does the household receive income?	How much income does the household have in total?	Is the tenant likely to be receiving any of these housing-related benefits?	How much of the household's income is from Universal Credit, state pensions or benefits?	Does the household pay rent or other charges for the accommodation?	How often does the household pay rent and other charges?	What is the basic rent?	What is the service charge?	What is the personal service charge?	What is the support charge?	After the household has received any housing-related benefits, will they still need to pay for rent and charges?	What do you expect the outstanding amount to be?
3	Additional info	You can find the org ID on the CORE service under 'Stock owners' or, if your organisation is the stock owner, under 'About your organisation'	You can find the org ID on the CORE service under 'Managing agents' or, if your organisation is the managing agent, under 'About your organisation'	If left empty, the letting log will be assigned to the account used to upload the log.	General needs housing includes both self-contained and shared housing without support or specific adaptations. Supported housing includes direct access hostels, group homes, residential care and nursing homes.	Scheme code. Include the 'S' at the beginning if it has one. You can find the scheme code on the CORE service under 'Schemes', either by searching for the specific scheme or downloading a csv.	Location code. You can find the location code on the CORE service under 'Schemes', either by searching for the specific location or downloading a csv.	If the property was previously being used as temporary accommodation, then answer 'no'.				See specification for definitions		This is how you usually refer to this tenancy on your own systems.	This is how you usually refer to this property on your own systems.	Make sure the lead tenant has seen or been given access to the Ministry of Housing, Communities and Local Government (MHCLG) privacy notice before completing this log. This is a legal requirement under data protection legislation.	Internal transfer - Where a tenant moved from one social housing property to another property. Their landlord may be the same or may have changed. Renewal of a fixed term tenancy - to the same tenant in the same property, except if was previously used as temporary accommodation.	This is the rent type of the previous tenancy in this property.	The Unique Property Reference Number (UPRN) is a unique number system created by Ordnance Survey and used by housing providers and various industries across the UK. An example UPRN is 10010457355. The UPRN may not be the same as the property reference assigned by your organisation.					Combined with field 22 it should be a postcode which lies within the local authority given in field 25.	Combined with field 21 it should be a postcode which lies within the local authority given in field 25.				This is whether someone who uses a wheelchair is able to make full use of all of the property’s rooms and facilities, including use of both inside and outside space, and entering and exiting the property.	If shared accommodation, enter the number of bedrooms occupied by this household. A bedsit has 1 bedroom.	Date the property was (legally/contractually) available to let, or for: - re-lets: the day after previous tenant’s contract end - new-builds: the day the landlord legally owned the property ('completion date’) - new conversions or acquisitions: the completion date, or the day after any rehabilitation work ended - new leases: the day the landlord got contractual property rights, and could let it out to tenants.			Major repairs are works that could not be reasonably carried out with a tenant living at the property. For example, structural repairs.			This includes retirement living, sheltered housing and extra care housing. There is no national set limit for “older people”, please answer based on your own policies. Extra care housing is for tenants with medium to high care and support needs, often with 24 hour access to support staff provided by an agency registered with the Care Quality Commission.	This is where two or more people are named on the tenancy agreement.	If the tenancy has an ‘introductory period’ answer ‘yes’. You should submit a CORE log at the beginning of the starter tenancy or introductory period, with the best information you have at the time. You do not need to submit a log when a tenant later rolls onto the main tenancy.	This is about the main tenancy after any starter or introductory period. See specification for definitions.		Do not include the starter or introductory period. The minimum period is 2 years for social or affordable rent general needs logs. You do not need to submit CORE logs for these types of tenancies if they are shorter than 2 years.	This is the household member who does the most paid work. If several people do the same amount of paid work, it's the oldest household member.	This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.		If the lead tenant is a dual national of the United Kingdom and another country, enter United Kingdom. If they are a dual national of two other countries, the tenant should decide which country to enter.	This is the household member who does the most paid work. If several people do the same amount of paid work, it's the oldest household member.		Answer 1 for children aged under 1 year old	This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.			Answer 1 for children aged under 1 year old	This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.			Answer 1 for children aged under 1 year old	This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.			Answer 1 for children aged under 1 year old	This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.			Answer 1 for children aged under 1 year old	This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.			Answer 1 for children aged under 1 year old	This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.			Answer 1 for children aged under 1 year old	This should be however they personally choose to identify from the options below. This may or may not be the same as their biological sex or the sex they were assigned at birth.		This excludes national service. If several household members have these links, answer for regular first. If no regular, answer for reserve. If no reserve, answer for spouses or civil partners.											For example, lifting and carrying objects, or using a keyboard		For example, deafness or partial hearing		For example, depression or anxiety	For example, walking short distances or climbing stairs	For example, anything associated with autism spectrum disorder (ASD), including Asperger’s or attention deficit hyperactivity disorder (ADHD)		For example, blindness or partial sight				The tenant's ‘last settled home' is their last long-standing home. For tenants who had temporary accommodation, sleeping rough or otherwise homeless, their last settled home is where they were living previously.				This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless.	Combined with field 104, it should be a postcode which lies within the local authority given in field 105.	Combined with field 103, it should be a postcode which lies within the local authority given in field 105.	This is the tenant’s last long-standing home. It is where the tenant was living before any period in temporary accommodation, sleeping rough or otherwise homeless.	Households may be given ‘reasonable preference’ for social housing under one or more specific category by the local authority. This is also known as ‘priority need’.						Where available vacant properties are advertised and applicants are able to bid for specific properties.	Where a common system agreed between a group of housing providers is used to determine applicants' priority for housing.	Where a single waiting list is used by a group of housing providers to receive and process housing applications. Providers may use different approaches to determine priority.	Where the 'access category' or another descriptor of whether an available vacant property meets a range of access needs is displayed to applicants during the allocations process.				Include any income after tax from employment, pensions, and Universal Credit. Don't include National Insurance (NI) contributions and tax, housing benefit, child benefit, or council tax support.	This is about when the tenant is in their new let. If they are unsure about the situation for their new let and their financial and working situation hasn’t changed significantly, answer based on what housing-related benefits they currently receive.		If rent is charged on the property then answer Yes, even if tenants do not pay it themselves.		This is the amount paid before any charges are added for services (for example, hot water or cleaning). Households may receive housing benefit or Universal Credit towards basic rent.	For example, cleaning. Households may get household benefits towards the service charge.	For example heating or hot water. This doesn’t include housing benefit or Universal Credit.	Any charges made to fund support services included in the tenancy agreement.	Also known as the 'outstanding amount'	You only need to give an approximate figure.
4	Values	Alphanumeric		Email format	01-Feb	Alphanumeric	Numeric	01-Feb	Jan-31	01-Dec	25 - 26	01-Jul	Text	Alphanumeric, max 13 characters	Alphanumeric, max 12 characters	1	5 - 6, or 8 - 22	1 - 3 or 5 - 9	Numeric	Alphanumeric		Text		Alphanumeric, 2 - 4 characters	Alphanumeric, 3 characters	9 character ONS code, beginning with 'E' (https://www.get-information-schools.service.gov.uk/Guidance/LaNameCodes)	1 - 2, 4 or 6 - 10	01-Feb	01-Feb	01-Jul	Jan-31	01-Dec	Jun-26	Jan-31	01-Dec	Jun-26	2 - 4, 7 - 8	01-Mar	01-Feb	02-Aug	Text	1 - 99, see specification for more detail	16 - 120 or R	F, M, X or R	Jan-20	3 digit ISO country code, see specification	0 - 10	01-Mar	Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9	F, M, X or R	0 - 10 Must be 9 if age <16	01-Mar	Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9	F, M, X or R	0 - 10 Must be 9 if age <16	01-Mar	Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9	F, M, X or R	0 - 10 Must be 9 if age <16	01-Mar	Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9	F, M, X or R	0 - 10 Must be 9 if age <16	01-Mar	Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9	F, M, X or R	0 - 10 Must be 9 if age <16	01-Mar	Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9	F, M, X or R	0 - 10 Must be 9 if age <16	01-Mar	Numeric, range 1 - 120 or text (upper case 'R') Must be >= 16 if working situation = 1 - 8 or 0 Must be <16 if working situation = 9	F, M, X or R	0 - 10 Must be 9 if age <16	01-Jun	03-Jun	01-Mar		1 or empty						01-Mar	1 or empty										1 - 2 or 6 - 12	2 or 6 - 13	1 - 2, 4, 8 - 14, 16 - 20, 28 - 31, 34 or 44 - 55	Text	3 - 4, 6 - 7, 9 - 10, 13 - 14, 18 - 19, 21, 23 - 33, 35, 37 - 39	1 or 11	01-Feb	Alphanumeric, 2 - 4 characters	Alphanumeric, 3 characters	9 character ONS code, beginning with 'E' (https://www.get-information-schools.service.gov.uk/Guidance/LaNameCodes)	01-Mar	1 or empty					01-Feb				1 - 4, 7 - 10, 14 - 24	01-Mar	01-Mar	0 - 99999	1, 3, 6, 9 or 10	01-Apr	0 - 1	01-Oct	xxxx.xx				01-Mar	xxxx.xx
5	Can be empty?	No		Yes	No	Yes, if letting is general needs (if field 4 = 1)	Yes, if letting is general needs (if field 4 = 1)	No					Yes, if letting is not 'Other intermediate rent product' (if field 11 is not 6)	Yes		No	Yes, if letting is a renewal (if field 7 = 1)	Yes, if letting is a renewal (if field 7 = 1) or a first-time let (if field 16 = 15 - 17)	Yes, if letting is supported housing (if field 4 = 2) or if the property's postcode is not empty (if fields 23 and 24 contain full and valid entries)	Yes, if letting is supported housing (if field 4 = 2) or if property's UPRN and local authority are known (if fields 18 and 25 are not empty)	Yes	Yes, if letting is supported housing (if field 4 = 2) or if property's UPRN and local authority are known (if fields 18 and 25 are not empty)	Yes	Yes, if letting is supported housing (if field 4 = 2) or if property's UPRN and local authority are known (if fields 18 and 25 are not empty)		Yes, if letting is supported housing (if field 4 = 2)					Yes, if letting is a renewal (if field 7 = 1)			Yes			Yes, if letting is general needs (if field 4 = 1)	No			Yes, if 'Other' is not selected for tenancy type (if field 39 is not 3)	Yes, if letting is not a fixed-term tenancy (if field 39 is not 4 or 6)	No					Yes, if all fields about person 2 are empty (fields 47 - 50)				Yes, if all fields about person 3 are empty (fields 51 - 54)				Yes, if all fields about person 4 are empty (fields 55 - 58)				Yes, if all fields about person 5 are empty (fields 59 - 62)				Yes, if all fields about person 6 are empty (fields 63 - 66)				Yes, if all fields about person 7 are empty (fields 67 - 70)				Yes, if all fields about person 8 are empty (fields 71 - 74)				No	Yes, if no one in the household is a current or former regular (if field 75 is not 1)	Yes, if no one in the household is a current or former regular or reserve (if field 75 is not 1 or 4)	No	Yes, if no household members have access needs or if it is unknown (if field 83 or 84 = 1)				Yes, if a household member has an access need (if at least one of fields 79 to 82 = 1)		No	Yes, if a household member has an access need (if at least one of fields 79 to 82 = 1) If someone in the household does have such a condition (if field 89 = 1), then at least 1 of these fields must be 1.										No	Yes, if letting is a renewal (if field 7 = 1)	No	Yes, if 'Other' is not selected for reason for leaving last settled home (if field 98 is not 20)	No	No		Yes, if postcode of household's last settled home is not known (if 102 = 2)		Yes	No	If household was given 'reasonable preference' (if field 107 = 1), at least one of these fields must be 1 If household was not given 'reasonable preference' (if field 106 = 2 or 3), these fields will be ignored.					No				Yes, if letting is a renewal (if field 7 = 1)	No	Yes, if household's income is unknown (if field 117 = 2 or 3)		No		Yes, if letting is supported housing (if field 4 = 2)	No	Yes, if the household does not pay rent (if field 122 = 1)				Yes, if the household doesn't receive housing benefits, or if it is unknown (if field 120 = 3, 9 or 10)	Yes, if the household does not need to pay rent or charges after receiving housing benefits (if field 128 is not 1)
6	Type of letting the question applies to					Supported housing only							Other Intermediate Rent only						General needs only																		Supported housing only																																																																																						Supported housing only
7	Duplicate check field?	Yes				Yes			Yes					Yes										Yes																			Yes				Yes
8	Field number	1	2	3	4	5	6	7	8	9	10	11	12	13	14	15	16	17	18	19	20	21	22	23	24	25	26	27	28	29	30	31	32	33	34	35	36	37	38	39	40	41	42	43	44	45	46	47	48	49	50	51	52	53	54	55	56	57	58	59	60	61	62	63	64	65	66	67	68	69	70	71	72	73	74	75	76	77	78	79	80	81	82	83	84	85	86	87	88	89	90	91	92	93	94	95	96	97	98	99	100	101	102	103	104	105	106	107	108	109	110	111	112	113	114	115	116	117	118	119	120	121	122	123	124	125	126	127	128	129
9		ORG1	ORG1	support@example.com	1			2	1	4	26	1		1	1	1	5	1		a	a	a	a	a1	1aa	E09000001	1	1	1	1	1	4	25					3	1	2			20	F	1	GBR	1																													1	6	3	1	1						1	1										1	2	50		30	1	2				1	1					1	1	1	1	7	2			1	2	1	1	50	0	0	0	3