Writing Pronunciation Help for Ambiguous Words
Writing Pronunciation Help for Ambiguous Words records a distinct W3C-supported accessibility writing task while keeping implementation mechanics outside the writing guidance.
Give pronunciation help when the meaning of a word or character cannot be determined reliably without knowing its pronunciation.
Key details
Important caveats
Scope Boundary
Do not add pronunciation notes to every ordinary word; target cases where meaning genuinely depends on pronunciation and context does not resolve it.
Further guidance
Content
Provide the needed pronunciation immediately, through a linked pronunciation, glossary entry, ruby/reading aid, or another clear mechanism appropriate to the language.
Purpose
Pronunciation help prevents ambiguous words or characters from becoming unintelligible when they are read aloud or cannot be disambiguated from context.
Sources and evidence
Sources are shown with the role they play in this guide. Historical or style-sensitive claims are kept within the evidence boundary described above.
- Understanding SC 3.1.6: Pronunciation (opens in a new tab)World Wide Web Consortium (W3C) · WCAG 2.2 guidance for providing pronunciation information when meaning is ambiguous without it.