A glossary is a collection of definitions for the vocabulary of a field. Many SaaS companies publish glossaries with a page for each term, aiming to answer "what is X" searches, introduce the company to people learning a field and support topical coverage. A useful glossary entry goes beyond the one-line definition to explain why the term matters and how it is applied.
What makes a glossary entry useful
The first sentence or two should answer the definition question directly, because that is what most visitors and AI systems need. The rest of the page should add depth: how it works, examples, common mistakes and related terms.
- A direct definition at the top
- Context: why the term matters and where it applies
- A worked example
- Links to related terms and deeper guides
- Sources for facts that need them
Structure and markup
Give each important term its own URL so it can be linked and cited individually, with an index page linking to all of them. Schema.org has DefinedTerm and DefinedTermSet types for glossaries. Google does not document a rich result for them, so treat the markup as optional.
Risks
Glossaries are easy to mass-produce, which tempts teams to publish hundreds of short, generic definitions. Those pages add little that searchers cannot find elsewhere. Fewer, better entries connected to the product tend to serve readers better.
Example
A glossary that supports a complex product
Hypothetical company Wickfield Analytics sells revenue analytics software to finance teams. New users and prospects are often unfamiliar with terms like net revenue retention. The company publishes a glossary of 60 terms, each with a definition, formula, example calculation and link to the product report that measures it.
Common mistakes
One-line entries
A page with a single sentence is thin. If a term does not merit a proper page, include it on an index page instead.
Copying other glossaries
Rewording another site's definitions adds nothing. Write from your own expertise and examples.
Questions
For terms people search for and that you can explain in depth, yes. Minor terms can live on a shared index page.
Sources
