Glossary Pages for a Technical Service Business
Short answer: A glossary earns its place when customers meet your jargon in quotes, surveys or reports and get stuck. Start with one well-organised page of short, plain definitions, link to it from the documents and service pages where the terms appear, and only give a term its own page when you have far more to say than a definition. Avoid churning out dozens of thin "what is X" pages; they help nobody and fit badly with Google's guidance on helpful content.
Every technical trade has words customers don't know: "rising damp", "DPC", "load-bearing", "U-value", "SLA". Many firms explain them over and over on the phone. A good glossary turns those repeated explanations into something a customer can read before or after your visit. This article walks through a hypothetical example, then gives a template.
When a glossary is worth doing
Ask three questions:
- Do customers see your terms in writing? Quotes, survey reports, maintenance schedules and proposals are where jargon bites. If your paperwork is plain already, a glossary adds little.
- Do the same questions come up repeatedly? If the office explains the same five terms every week, that's your starting list.
- Does a misunderstanding cost you? Confusion about what a quote includes leads to disputes, cancelled jobs and slow approvals.
If at least two answers are yes, a glossary is worth an afternoon.
Plain explanations aren't only for beginners. Nielsen Norman Group's research on plain language argues that even expert readers prefer clear, concise text without unnecessary jargon, because it lets them get the point quickly. A facilities manager comparing three contractors is busy, not uninformed.
The worked example: a hypothetical damp-proofing firm
Imagine a damp and timber specialist in the Midlands. Its survey reports use terms like "rising damp", "penetrating damp", "condensation", "chemical DPC injection", "tanking", "replastering with renovating plaster" and "hygroscopic salts". Homeowners read the report at the kitchen table, don't understand half of it, and phone with questions or simply don't reply.
Step 1: collect the terms. The office manager goes through ten recent survey reports and quotes and lists every term a homeowner might not know. The list comes to about 35.
Step 2: cut it down. Some terms only appear once in a blue moon. Others are everyday words. The firm keeps the 20 that appear in most reports and quotes.
Step 3: write definitions in three parts. Each entry follows the same shape:
- What it is in one sentence a homeowner would use.
- Why it matters for their house or their quote.
- What we'd normally do (or "see your survey for what we recommend").
For example, written for the hypothetical firm:
Hygroscopic salts: Salts left behind in walls after water evaporates. They draw moisture from the air, so a wall can stay damp even after the original cause is fixed. This is why we often recommend replacing affected plaster rather than just repainting it.
Step 4: organise for scanning. The page groups terms by theme (types of damp, treatments, building parts) with an A–Z index at the top. Each term gets an anchor, so a report can link straight to "#hygroscopic-salts".
Step 5: link from where the confusion happens. This is the step that makes the glossary useful rather than decorative:
- The PDF survey template includes a line: "Unfamiliar terms are explained at [web address]/glossary".
- Quotes link the key treatment terms to their glossary entries.
- Service pages link to the two or three terms most relevant to that service.
Step 6: decide which terms deserve more. Two terms, "rising damp" and "condensation", generate so many questions that the firm gives each its own in-depth page with photos, how to tell them apart and when to call someone. The glossary entry stays short and links to the full page.
One page or a page per term?
| Approach | Good for | Watch out for |
|---|---|---|
| One glossary page | 10–60 short definitions; linking from documents | Very long pages need an index and anchors |
| Glossary plus a few in-depth pages | Terms customers actively search and need detail on | Keep the deep pages genuinely detailed |
| A separate page for every term | Rarely right for a small firm | Thin pages with one paragraph each |
The last option is where firms get into trouble. Google's helpful content guidance asks whether content gives a substantial, complete description of the topic and adds value beyond the obvious, and whether it was written for an existing audience or simply to attract search visits. Its spam policies describe "scaled content abuse": producing many pages mainly to manipulate rankings, with little value to users, however they're made. Fifty one-paragraph "What is…" pages, each with the same call to action, look much more like the second than the first.
Writing definitions that actually help
- Use the customer's words first. "Damp proof course (DPC)" is better than "DPC (damp proof course)" for someone who has never heard the abbreviation.
- Keep each definition short. Two to four sentences. Link out for more.
- Be accurate and consistent. The glossary is a promise about what your terms mean. If your quotes use "tanking" for something specific, define it the same way.
- Add a picture where it saves words. A labelled photo of a cavity wall explains more than a paragraph.
- Mark the date you last checked it. Technical terms change slowly, but products and methods do change.
Keeping it alive
- When a customer asks "what does this mean?", check whether the term is in the glossary. If not, add it.
- Review the page twice a year alongside your quote and report templates.
- Remove terms you've stopped using.
A template you can copy
Page title: "[Trade] terms explained: a plain-English glossary" Intro (2–3 sentences): who it's for and how to use it. Index: A–Z letters or theme headings linking to anchors. Entry format: term (and common abbreviation) → what it is → why it matters → what we'd usually do → link to more detail if it exists. Footer: "Can't find a term? Ask us" with your contact details.
FAQ
Will a glossary help my search rankings?
It might help people find you for questions about your terms, but that's a side benefit. The main value is clearer quotes and fewer confused calls. Write it for customers first.
Should glossary terms link to my service pages?
Yes, where it's natural. A definition of "tanking" can link to your basement waterproofing service; it shouldn't turn every entry into a sales pitch.
How many terms should I include?
Enough to cover what customers actually meet in your paperwork. For most small firms that's somewhere between a dozen and a few dozen.
Can I use AI to write the definitions?
It can draft them, but every definition must be checked by someone who does the work. A confidently wrong definition is worse than none.
If your quotes and reports keep generating the same phone calls, send us a sample document and we'll suggest which terms deserve explaining online.