All articles
Documentation May 15, 2026 5 min read

How to Document Construction Defects Effectively

Photos, timestamps, and written records are your most powerful tools. Learn the right way to document every defect before contacting your builder.

Why Documentation Is Everything


In a warranty dispute with a builder, the homeowner who documents wins. The builder who delays wins against the homeowner who doesn't document.


This is not cynical — it's practical. Without a written, timestamped record, you have no proof of when a defect was discovered, when it was reported, or how the builder responded. With a complete record, you have leverage at every stage: negotiation, mediation, arbitration, or litigation.


The Five Elements of Effective Documentation


1. Photographs with metadata

Every photo you take should have its timestamp intact. Do not edit or screenshot photos — use the originals. Photograph the defect from multiple angles, including a wide shot showing the context and a close-up showing the specific issue. Include a ruler or common object for scale when relevant.


2. Written description

Write a clear description of the defect: what it is, where it is located (room, wall, floor, exterior), when you first noticed it, and whether it has changed or worsened.


3. Date of discovery

Record the exact date you discovered the defect. This matters for warranty eligibility. "I noticed the crack in the foundation wall on March 15, 2026" is far more useful than "sometime this spring."


4. Impact assessment

Note whether the defect is causing secondary damage. A small roof leak may be cosmetic — or it may be causing mold growth inside the wall cavity. Document any consequences you can observe.


5. Submission proof

Document not just the defect itself, but your report of it. An email to your builder's warranty department, sent from a datestamped email, creates an indisputable record of when you reported it.


Common Defects to Watch For by Category


**Structural:** Foundation cracks (especially horizontal), sagging floors, sticking doors that weren't sticking before, gaps between wall and ceiling.


**Water:** Staining on ceilings or walls, musty odors, efflorescence on concrete, water pooling near the foundation after rain.


**HVAC:** Rooms that won't reach temperature, excessive utility bills, unusual noises from the system, condensation around vents.


**Electrical:** Outlets that don't work, breakers that trip repeatedly, GFCI outlets that won't reset, flickering lights.


**Plumbing:** Low pressure, slow drains, water discoloration, gurgling sounds, water spots under sinks.


**Cosmetic (Year 1 only):** Nail pops, drywall cracks at corners, paint peeling or bubbling, grout cracking, flooring gaps.


Using Oluso for Documentation


Oluso structures your documentation automatically. When you file a claim, you specify the category, severity, and location. You can attach photos directly. The claim gets a timestamp and a unique email address that routes all builder communications into your record.


When you send the builder an email from that claim thread, their reply is automatically logged — including the timestamp. This is how you prove response time in a dispute.


Document everything. Start today.

Start documenting your warranty claims

Free to use. Timestamped. Permanent record.

Go to Dashboard