Expand acronyms and mark defined terms so AI captures their meaning
Use abbr for acronyms and dfn for term definitions, with dl for glossaries.
What this signal tests
We check that acronyms in your content (uppercase tokens like API or HTTP) are either wrapped in an abbr element with a title attribute giving the full form, or expanded inline on first use, for example "Application Programming Interface (API)". On glossary, FAQ, or definitions pages, we additionally check that term–definition pairs use the dl, dt, and dd elements rather than ad-hoc paragraphs.
Why it matters for your visibility in AI
AI systems extract glossaries and term definitions to build reference knowledge. When you wrap a defined term in dfn, or expand an acronym in abbr title, you give the extractor a machine-readable hook: this token means that. Without those hooks, the extractor has to infer from context, and inference fails on the very acronyms that are most ambiguous (API, ML, IP - each has multiple expansions). The concrete consequence is that an AI assistant explaining your domain may pick the wrong expansion of an acronym you used, or fail to surface your glossary entry when a user asks for a definition. A glossary marked up as dl/dt/dd is harvested cleanly; the same pairs in two-column paragraphs are noise.
Pass criteria at a glance
| Criterion | Passes when |
|---|---|
| >=80% acronyms expanded; glossary pages use <dl>/<dt>/<dd>. |
How we test it
We scan body text for short uppercase tokens (two to six characters, optionally followed by an s) and check whether the first occurrence is wrapped in an abbr element with a title attribute, or followed by a parenthesized expansion. On pages whose URL contains "glossary", "faq", or "definitions", we additionally check that at least sixty percent of detected term–definition structures use the dl element. The page passes when at least eighty percent of acronyms are expanded.
Show technical detection method
Detect ^[A-Z]{2,6}s?$ tokens with no inline expansion; assert first use is <abbr title> or followed by parenthesized expansion. For pages matching /(glossary|faq|definitions)/i assert >=60% term-definition coverage uses <dl>.
If your site fails: how to fix it
- On first use of any acronym, expand it inline as "Full Form (XYZ)", then use the short form for the rest of the page; this works in any CMS without requiring HTML edits.
- For tooltips on hover-friendly designs, wrap the acronym in <abbr title="Full Form">XYZ</abbr>; browsers render the title as a hover tooltip automatically.
- Convert glossary pages from paragraph or table layouts into description lists: each term becomes a dt and its definition a dd, with dl wrapping the whole set.
- For defined terms within an article (not a glossary), wrap the first use in dfn - this marks it as the canonical definition occurrence and AI extractors will lift it.
- Avoid wrapping every uppercase string in abbr; the element is for actual acronyms and initialisms, not for trademarks, model numbers, or arbitrary capitals.
Quick facts
| Maturity | ESTABLISHED |
|---|---|
| Weight | low |
| Category | Content Clarity |
Primary sources
Related signals
No related signals listed.
Frequently asked questions
Do I need to mark up every occurrence of an acronym?
First-use marking is enough. AI extractors carry the expansion forward through the rest of the document once they have seen it. Repeating <abbr title="…"> on every occurrence is technically valid but clutters the markup; first use plus inline expansion is the practical pattern.
What is the difference between abbr and dfn?
Abbr marks an abbreviated form ("API") with its full expansion. Dfn marks the canonical defining occurrence of a term, often in a longer phrase ("a denormalized reference table, or fact table, is…"). Use abbr for shortened forms and dfn for the moment you formally introduce a concept.
Will using dl for my glossary look different visually?
Browsers render dl, dt, dd with default styling that resembles indented definitions; CSS can match any visual design you currently have. The semantic structure works under the hood without forcing a redesign - visual continuity and structural correctness are independent here.
Run your own scan
Run a free scan and see how your site grades across all 155 AI-readiness signals.