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.

By , founder of Porteur · Updated 15 September 2026 · Markdown

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 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.

PartThe thin versionThe 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 nuanceAbsent, 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 outA 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.

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

Check my site, free

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, no card
  • Read-only, your own accounts
  • Readable by your agent

Read next