# How to build a glossary that earns traffic and links

A glossary works when every entry answers one definition search completely and links to the page that goes deeper. It fails when it becomes two hundred stubs nobody asked for. Here is how to choose the terms, write the entry, wire the links, and stay on the right side of that line.

Updated 2026-09-15 · Source: https://porteur.ai/guides/how-to-write-a-glossary

## What a glossary earns, and what it does not

People search definitions constantly, and a definition search is answered in a paragraph. That is the whole opportunity: short pages, low competition, a reader who is one step from the thing you sell.

- Search traffic from "what is X" and "X meaning" queries, which your long guides answer badly because they bury the definition.
- Links, because a writer explaining something needs a clean page to point at for the term they do not want to define again.
- Citations from assistants, which quote a first sentence that defines a thing plainly.
- Internal links, because every guide you write mentions terms that now have a page of their own.

What it does not earn: buyers, directly. Someone searching "canonical url" is learning, not choosing a product. Treat the glossary as the top of your library, not as a sales surface.

## Which terms deserve an entry

Start from your own writing, not from a keyword list. Open the guides you have already published and collect every term you used without defining. Those are the entries that will be read, because your own pages will link to them.

- A term your guides use and your reader might not know: it earns an entry.
- A term with a real definition search behind it ("what is X", "X meaning", "X vs Y"): it earns an entry.
- A term you can define more precisely than the pages that rank, because you work with it: it earns an entry.
- A term that is a synonym of one you already covered: it does not. Add the synonym to the existing entry's secondary searches.
- A term nobody in your category uses: it does not, however many words you could write about it.

> The test: would one of your own guides link to this entry within the next month? If no page of yours needs it, the entry is for a keyword, not a reader.

## The shape of an entry

Definition first, in one sentence, before any context. An assistant quoting your page will quote that sentence, and a reader who only wanted the definition can leave satisfied. Everything after it is for the reader who stayed.

1. **The definition** One sentence, no hedging, no "it depends". Write it so it would survive being read aloud out of context.
2. **The nuance** The part people get wrong. For a metric, what it does not measure. For a tag, when it is ignored. This is where your entry beats the ten that copy each other.
3. **Where it matters** What a founder does differently because of it, with a named page or a named report. Abstract definitions are forgettable.
4. **The way out** A link to the guide that does the work, when there is one. The entry defines; the guide changes something.

Four hundred to seven hundred words covers that. A definition padded to fifteen hundred words to look substantial reads as padding, and the reader who came for one sentence bounces past four screens of throat clearing.

## A thin entry against a real one

The difference is not length. It is whether the page holds anything the reader could not have guessed.

| Part | The thin version | The version worth publishing |
| --- | --- | --- |
| First sentence | "Canonical tags are an important part of SEO." | "A canonical tag tells search engines which URL is the original when the same content exists at several addresses." |
| The nuance | Absent, or "it is important to use them correctly". | Google treats it as a hint, not a command, and can choose a different URL; the Page indexing report tells you which one it picked. |
| Where it matters | "Every website should use canonical tags." | Parameters, trailing slashes, print views and a staging host are the four places a small site creates duplicates without meaning to. |
| The way out | A link to the home page. | A link to the guide on fixing the canonical Google disagreed with. |

Write the thin column and you have a page that competes with nothing, helps nobody, and adds one more URL Google has to judge before it judges your site.

## How entries link to the rest of the library

A glossary that nothing links to is a hundred orphan pages. The linking is what turns the terms into a structure.

- From the guides down: the first time a guide uses a term, link it to the entry. Once per page, on the first mention, so the text stays readable.
- From the entries across: each entry links to the two or three terms it depends on. A definition of impressions links to clicks and to click-through rate.
- From the entries out: each entry links to the guide that acts on it, which is the only link on the page that leads to work.
- From a hub: one A to Z page listing every entry, so a reader browsing finds them and a crawler reaches them all in two clicks.

If your site is generated from files or a CMS, do the first-mention linking automatically. A dictionary of term to slug, applied once per page at render time, keeps two hundred entries linked without anyone remembering to do it by hand.

> Automatic linking has one rule: link the first mention only, and never inside a heading or a link you already wrote. Repeated links to the same entry in one page add nothing and make the prose look like a phishing email.

## Where a glossary becomes thin content

Google's spam policies describe scaled content abuse as producing many pages primarily to rank rather than to help people, whatever produces them: automation, humans, or both. Two hundred generated definitions of terms nobody uses is the example the policy was written for.

- Every entry holds something of its own: a nuance, a worked example, a table, a number from the documentation.
- Every entry is a term that appears in your own writing or in your buyers' questions.
- No entry exists only as a variant of another ("backlink", "back link", "backlinks" are one page).
- The batch is sized to what you can keep accurate. Twenty entries you maintain beat two hundred you abandon.

The signal to watch afterwards is the Page indexing report. If a batch of new entries settles into "Crawled, currently not indexed", Google has judged that template and told you plainly what it thinks.

## Keeping it accurate

Definitions date faster than guides, because the things they define get renamed and retired. A metric is replaced, a tool drops a feature, a report changes its name.

1. **Show the date** Put the last updated date on every entry. A definition with no date is a definition nobody can trust.
2. **Review once a quarter** Open the ten entries with the most impressions and check every claim against the source documentation. That is an hour.
3. **Fix the whole chain** When a term is renamed, update the entry, the guides that link to it, and the term dictionary, in that order.
4. **Retire rather than keep** An entry for something that no longer exists gets rewritten to say so, or is merged into the term that replaced it with a redirect.

## Questions

### How many entries should a glossary have?

As many as your own guides need, and no more. Start with the terms you have already used without defining, which is usually twenty to forty for a site with a dozen guides. Add entries as you write, not in a batch to reach a number.

### Should glossary entries be separate pages or one long page?

Separate pages, if each term has its own definition search behind it. One page can only rank for one main query, so a single long glossary wins one search while twenty entries can win twenty. Keep the single A to Z page as the hub that links them.

### How long should a glossary entry be?

Four hundred to seven hundred words is enough for a definition, the nuance and where it matters. Length is not what ranks; the top results for the term are the brief. If they all answer in three paragraphs, a fifteen hundred word page is padding.

### Do glossary pages count as thin content?

Not if each holds something of its own. Google acts on pages made at scale with no value of their own, not on short pages. A four hundred word definition that is more precise than the alternatives is not thin; a four hundred word paraphrase of a dictionary is.

### Will a glossary bring me customers?

Rarely, directly. People searching definitions are learning. The glossary earns links, citations and internal linking strength that help the pages which do convert, and it catches readers early. Judge it on impressions and links, not on signups.

### Should every mention of a term link to its entry?

Only the first mention on a page. Linking every occurrence clutters the text and passes nothing extra. Never link a term inside a heading, and never inside a sentence where the reader is already following a different link.

## Read next

- [Topic clusters: the hub, the spokes, and the links that make them one thing](https://porteur.ai/guides/topic-clusters): What a topic cluster is, what makes a hub worth reading rather than a list of links, and the link pattern that holds the whole thing together.
- [Thin content](https://porteur.ai/glossary/thin-content): Thin content is a page with little value of its own. See why it drags a small site, how to spot it, and how to expand, merge or remove.
- [Internal linking for a small site: which pages link to which](https://porteur.ai/guides/internal-linking-for-seo): Decide which pages rank. Build hubs, write clear anchors, fix orphans, and crawl your site to map links you control.
- [Scaled content abuse](https://porteur.ai/glossary/scaled-content-abuse): What scaled content abuse means in Google’s spam policy, how to avoid it on a small site, how to check risk, and what to fix fast.
- [Pillar page](https://porteur.ai/glossary/pillar-page): A pillar page is a hub that covers a whole topic and links to deeper pages. See when to use it, how to structure the cluster and what to measure.
- [Orphan pages: finding the pages nothing links to](https://porteur.ai/guides/orphan-pages): Find orphan pages on your site, why they happen, how to compare crawl, sitemap and Search Console, and what to do: link, merge, redirect or remove.

Paste your URL and the free check reads your site and the searches around it in about thirty seconds, then names the terms and pages worth writing next. Free check: https://porteur.ai/