Writing & StyleStyle guide

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.

Quick answer

Give pronunciation help when the meaning of a word or character cannot be determined reliably without knowing its pronunciation.

Key details

Core IssueWCAG 2.2 SC 3.1.6 calls for a mechanism to identify pronunciation when a word’s meaning is ambiguous without knowing how it is pronounced.
Registerweb accessibility and interface content

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.

Practical Application

Provide a pronunciation cue only where pronunciation is needed to determine meaning reliably. Keep the cue adjacent to the ambiguous term and choose a notation appropriate to the audience rather than adding pronunciation information indiscriminately.

Purpose

Pronunciation help prevents ambiguous words or characters from becoming unintelligible when they are read aloud or cannot be disambiguated from context.

Reader Check

Could two plausible pronunciations of this written form lead readers to different meanings in this context?

Worked Example

If a specialized name or character sequence has two readings that would change the intended meaning, add a clear pronunciation guide at first use; omit it when pronunciation does not affect interpretation.

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.

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

Explore the topic