Start with the decision
A maintenance report should support an informed first review.
The initial record rarely needs every detail required to complete the work. It should contain enough reliable context for the responsible team to understand the issue, recognise obvious risk and choose the next action.
Property teams often receive reports through telephone calls, emails, messaging channels and online forms. The quality varies because each route asks for different information—or asks only for a free-text description. A consistent minimum record makes reports easier to compare, route and progress.
The minimum useful maintenance record
- The correct property or building context.
- A precise location within the property or communal area.
- A plain-language description of the observed condition or service problem.
- When the issue was noticed and whether it is constant, intermittent or worsening.
- Practical indicators of immediate risk, service loss, spread or security impact.
- Optional photographs or supporting evidence where they can be obtained safely.
- A contact route and relevant access information for follow-up.
- A reference, submission time and clear ownership within the receiving team.
Remove ambiguity
Describe exactly where the issue is.
Location is one of the most common missing details. A property address identifies the building or home; it does not identify the affected room, floor, doorway, riser, corridor or fitting.
Ask location in a dedicated field rather than expecting the reader to extract it from a long description. For communal reports, resolve the building automatically where possible and ask the resident to identify the specific area.
Useful location prompts
- Floor or level, including basement, ground, mezzanine or roof level.
- Named communal area such as entrance lobby, lift, stairwell, corridor, bin store or cycle store.
- Nearest flat, door, room, landmark or service cupboard.
- Inside or outside the property, and which elevation or side where relevant.
- The exact fitting or item, such as the left-hand entrance door closer or the light outside flat 14.
- Whether the issue affects one location or appears in several connected areas.
The light in the building is not working.
The ceiling light on the second-floor west corridor, between flats 12 and 14, is not working. The stairwell lights on the same floor are still on.
Avoid overly technical location lists that residents cannot recognise. Clear building language and familiar landmarks are often more accurate than internal asset names or contractor codes.
Record what is observed
Use plain-language questions that reveal condition, behaviour and impact.
The strongest descriptions explain what is happening without forcing the reporter to choose an uncertain cause or repair category.
A clear description may explain
- What is not working, damaged, loose, blocked, leaking, noisy, hot, cold, stained or missing.
- What happens when the item is used, opened, closed, switched on or left untouched.
- Whether the condition is constant, intermittent, seasonal or linked to weather or another activity.
- Whether the issue is spreading, recurring or affecting another room, floor or service.
- The effect on normal use, access, security, hygiene, heating, water, lighting or mobility.
- Any visible labels, error codes, asset numbers or warning indicators that can be copied safely.
The door is broken.
The main entrance door closes but does not latch unless it is pulled firmly. It has been happening since this morning, so the entrance can remain unsecured after someone enters.
Separate category from description
A category can help route a report, but it should not replace the resident's own description. “Door and access” is useful for sorting; the observed latching problem explains why the record matters.
Use prompts instead of one oversized text box
Separate fields for location, timing, urgency and description reduce the chance that essential context is buried or omitted. Keep an additional-notes field for details that do not fit the guided questions.
Support safe triage
Ask about observable risk and impact—not whether the resident thinks it is an emergency.
Urgency should be determined through an approved triage process. Resident questions can provide practical indicators without delegating the final priority decision.
Practical urgency indicators
- Is anyone in immediate danger or unable to leave or enter safely?
- Is there active water flow, flooding, smoke, burning smell, exposed wiring or another worsening condition?
- Is a communal entrance, fire door, window or gate unable to close or secure?
- Is an essential service unavailable, and how many homes or areas appear affected?
- Is the issue blocking an access route, lift, stairway or facility needed by a resident with limited mobility?
- Has the condition spread, changed quickly or caused secondary damage?
- Has an emergency, utility or specialist service already been contacted?
Avoid asking the resident to choose an internal priority label such as P1, P2 or routine. Those labels may be unfamiliar and can mean different things across organisations. Ask about the real-world condition and apply the operational priority during triage.
Use images with purpose
Photographs should add context, not create risk or replace the written record.
A useful image can clarify condition, scale and surrounding access. A poorly framed close-up may provide no location or may encourage unsafe evidence collection.
Guidance for useful maintenance photographs
- Take one wider photograph showing the item within the room or communal location.
- Take a closer photograph showing the visible condition, damage, label or error code.
- Use normal lighting where possible and check that the image is not blurred.
- Avoid including people, personal documents, neighbours' homes or unrelated private information.
- Do not move guards, covers or panels, and do not touch exposed or damaged electrical items.
- Do not climb, lean from windows, enter restricted areas or approach an active hazard for a better image.
- Treat images as supporting evidence; always retain a written location and description.
Image uploads should fail safely. A resident should receive a clear message when a file is unsupported or too large, and a photo-storage failure should not expose internal paths or provider errors.
Make follow-up possible
Collect the contact and access details needed for the next step.
Contact information should be proportionate to the report and should not be displayed more widely than the operational process requires.
Follow-up information may include
- Reporter name where identification is required or useful.
- Telephone number, email address or another approved contact method.
- Flat or unit number where it helps identify proximity, access or the affected household.
- Times when the person can be contacted or can provide access.
- Whether the issue is wholly communal or requires entry to a home or private area.
- An authorised representative or alternative contact where applicable.
- A clear communication preference and any separately managed messaging consent.
Keep public reporting details separate from private engineer access information. A resident-facing QR route may identify the block and collect a contact, but it should not reveal key-safe codes, internal escalation contacts, protected site documents or utility isolation details.
Use a repeatable structure
A practical maintenance-report template.
This sequence can be adapted for communal reporting, contact-centre scripts, online forms and staff-created records.
- 01
Identify the property context
Resolve or confirm the building, property, flat or unit without asking the reporter to know internal references.
- 02
Record the exact location
Ask for the floor, room, communal area, nearest landmark and affected fitting or item.
- 03
Describe what is happening
Capture the observed condition, behaviour, impact and any visible warning or error information.
- 04
Record timing and change
Ask when it started, whether it is constant or intermittent and whether it is worsening or spreading.
- 05
Check observable risk
Use practical questions about danger, service loss, security, access and active deterioration.
- 06
Add safe evidence
Request optional context and close-up photographs only where they can be obtained without risk.
- 07
Confirm contact and access
Collect the proportionate details needed for clarification, attendance or resident updates.
- 08
Create the operational handover
Generate a reference, timestamp the record, route it to an owner and retain the source and notification history.
Copy-and-review template
- Property or building:
- Exact location of the issue:
- What can be seen, heard, smelled or experienced:
- When it started and whether it is changing:
- Immediate risk, service loss, spread or security impact:
- Photographs or supporting evidence:
- Reporter and preferred contact route:
- Access information relevant to follow-up:
- Submission source, reference and time:
- Assigned owner, first review and next action:
Improve the reporting process
Review whether reports are complete, understandable and used.
Information quality improves when the team measures recurring gaps and changes the questions—not when residents are repeatedly chased for the same missing detail.
Quality-review questions
- Can the reviewer identify the exact location without contacting the resident?
- Does the description explain the observed condition rather than only naming a category?
- Is there enough timing information to understand whether the issue is new, recurring or worsening?
- Are urgency indicators based on observable impact and risk?
- Do photographs add useful context and remain protected from public access?
- Can the team contact the reporter or arrange access when follow-up is genuinely needed?
- Is the report attached to the correct building or property and routed to a named owner?
- Are missing details caused by optional fields, confusing labels or questions residents cannot answer?
- Does the receiving team actually use every field that has been marked as required?
Use recurring incomplete reports to refine the journey. For example, if reviewers repeatedly call to ask which floor is affected, create a dedicated location prompt instead of adding another sentence to the description placeholder.
For a building-specific digital entry point, read the guide to QR code reporting for communal buildings. The FSEngage resident-reporting solution shows how guided questions, private evidence and office review can remain part of one controlled record.