A matter record holds every detail the documents need
In a busy Rosebank practice, a matter record carries parties, dates, property details and deadlines as well as the file number. It holds the party details, property descriptions, identity information, date fields, fee references, contact details, and the facts that feed contracts, letters, wills and lease paperwork.
When those details live in different spreadsheets, old Word versions and message threads, people waste time checking which version is current. A cleanup pass brings those fields into one structure, so the team is working from the same source.
For firms planning document automation, that stage comes before any template work. A clean matter record gives merge fields something reliable to pull from, and it reduces the chance of a clause picking up the wrong party name or an old address from another file.
Where data drifts in a small firm
Data drift usually starts with admin shortcuts. Someone types a client surname in all caps, another person shortens a street address, and a third copies a matter note into the wrong field because the file is under pressure. After a few months, the record set no longer behaves in a predictable way.
That shows up quickly when questionnaires and template libraries are linked to matter data. One field says company name, another says registered name, and the same client appears in three formats across old files. The drafting team then has to clean the record by hand before anything can be issued.
- Fields are entered with different spellings or punctuation
- One matter uses free text where a fixed value should sit
- Dates, ID numbers and addresses are stored in inconsistent formats
- Old files keep carrying forward out of date party details
What a cleanup pass should sort first
The first task is to make the data dependable. A practical cleanup usually starts with the fields that appear in most documents: client names, opposing party names, ID or registration details, address lines, matter type, file reference, and the people authorised to review or sign off.
After that, a firm can decide which fields need fixed choices and which can stay open. For example, matter type, office location, property status or document category often work better as controlled values. Free text can still have a place for notes, but it should not carry details that need to flow into repeated documents.
- Standardise naming for people, entities and matter types
- Separate fixed fields from free text notes
- Set one format for dates, addresses and reference numbers
- Remove duplicate fields that ask for the same detail twice
Templates and clause banks need clean inputs
A template library only performs well when the input fields are tidy. If a contract template expects one party name and the matter record offers three similar fields, the team ends up testing each version. Clause banks have the same issue, especially when conditions depend on a value that may have been entered in different ways.
Conditional questionnaires work best when each answer maps to a specific field in the matter record. If the answer for property type can be typed as sectional title, sectional, or flat, the automation logic becomes harder to manage. A cleanup session lets the firm settle the label, the meaning and the place where that information should live.
Once the mapping is clear, version control is easier to run. The team knows which template version uses which fields, and review and sign off steps can focus on the drafting.
A Johannesburg property matter can expose the weak spots
Take a conveyancing file for a Johannesburg firm dealing with a residential transfer in the northern suburbs. The matter needs the correct names, identity details, property description, postal address, contact person and the right file stage. If any of those items sit in the wrong field, the wrong information can move into the letter, instruction sheet or supporting paperwork.
That is where cleanup helps most. It lets the firm set a stable structure before anyone starts filling approved templates. The result is cleaner drafting and fewer interruptions when the matter moves from intake to document preparation to sign off.
For firms working across Pretoria, Cape Town, Durban or Bloemfontein as well, a shared field structure helps the team handle matters in the same way no matter which office opened the file.
Keep the record plain to work with and simple for a small team to manage
Cleanup should leave admin staff with fewer fields to fix. If the structure becomes too detailed, the team avoids it and slips back into old habits. The record should match the way the firm works and hold every real matter without workarounds.
That is also where secure cloud storage and POPIA-aware handling matter. The firm needs to know who can see which fields, where the record is stored, and how changes are tracked when information moves between onboarding, drafting, review and final issue. A tidy record supports that control because fewer people need to patch gaps by hand.
- Keep the field list short enough for daily use
- Track changes so the latest version is visible
- Limit access to sensitive matter data where needed
- Review the structure after the first few live matters
What a cleaner start gives the drafting team
When matter data is cleaned before automation goes live, the drafting team spends less time checking basics. Letters of demand, leases, wills, contracts and routine agreements all benefit from the same discipline: one record, one structure, one agreed set of fields.
For a small firm, that can be the difference between a system that gets used and one that sits half-finished because people do not trust the inputs. Clean data gives the drafting process a steadier base, with professional judgement still in charge.
At LawMachine, our work on matter data design fits alongside template mapping, clause bank setup, questionnaire design and go-live support for firms across South Africa. The cleaner the record, the easier it is to keep drafting orderly when the pace of the file starts to pick up.
