Expand on first use or offer an explanation affordance
Aliases: expand on first use · explanation affordance · abbreviation scope
What it is
Scoped explanation means users can obtain the full form or practical meaning of an unfamiliar abbreviation within the reasonable scope of the current task. “First use” is not one string that appears first across the whole product; it is a comprehensible starting point relative to a page, flow, session, document section, or independent entry. The explanation may be inline expansion, a clear label, adjacent copy, expandable detail, or accessible help. The goal is understanding and decision quality, not formally spelling out every set of letters once.
Why it happens
Users need a retrievable pairing between an abbreviation and its meaning, but digital products have no single reading order: deep links, search results, notifications, and shared content can all be entry points. If the only explanation sits on an onboarding page a user never saw, the current token remains unknown. Greater distance from a decision adds search and working-memory cost, while repeating the full expansion everywhere adds scanning noise for experienced users. Scope design balances the two: restore necessary context at independent entries and consequential decisions, then allow the short form within a continuous, visible local context.
Studying it
Map where users can enter and leave a task, then mark each abbreviation's first visibility, first effect on judgment, and explanation location. Test with new, returning, and assistive-technology users: can they discover and operate the explanation, preserve context on return, and describe the consequence in their own words? Compare inline expansion, adjacent plain-language text, detail panels, and help links on completion time, comprehension errors, and scanning burden. Do not test only mouse hover, and do not treat click counts as a proxy for understanding.
Where it stops holding
A full form is not always a useful explanation: a foreign-language expansion, statutory name, or technical title may still need a statement of what it does here. Continuous prose can expand by section or local scope; repeated tables may use a column heading or persistently reachable explanation. Consent, payment, security, and irreversible actions should keep meaning visible at the decision. A tooltip is only one candidate and must not be the sole solution: it may be undiscoverable, unavailable to touch, keyboard, or some assistive technologies, and unsuitable for consequential details. An abbreviation demonstrated familiar does not need mechanical expansion everywhere.
Applying it
- Define explanation content and scope for each abbreviation: full form, plain meaning, affected object, and where context must be re-established across pages, flows, sessions, or documents.
- Prefer inline or adjacent explanations that require no extra discovery. Under space constraints, provide a named, focusable, touch-operable, screen-reader-accessible details control whose close action returns focus.
- Do not make independent notifications, search landing pages, or deep links rely on an upstream explanation. At consequential decisions, retain enough object and outcome detail even if the abbreviation appeared earlier.
- Regress the affordance on real devices with zoom, keyboard, and screen readers. Also check whether repeated expansion creates noise, and adjust scope using comprehension evidence.
Related
- Same group: T1.05.1 Use abbreviations only when the target audience already knows them · T1.05.3 Internal codenames must never reach the user interface
- Adjacent: T2.03.3 Fields of unclear purpose need explanation · T1.07.2 The target reader decides acceptable complexity
- Search terms:
expand on first use·explanation affordance·scope of first use