Text Style Adjustable
Group: text-and-wording • Guideline: text-appearance
Summary in Plain English
Text style properties can be adjusted without losing content or functionality - typeface, font width, text decoration, capitalisation and automatic hyphenation - to values still to be determined. Hard-coded styling is exempt.
Why It Matters
Readers with dyslexia often substitute a typeface, and all-caps or hyphenated text is markedly harder to read. Being able to change these is what makes text legible for them.
Scope: When This Applies
The draft's own conditions, quoted from guidelines/groups/text-and-wording/text-appearance/text-style-adjustable.md.
Except when
- the text style property is hard-coded, such as raw text that is capitalized or hyphenated.
Notes in the draft
The requirement is that the text is manipulable and the style attributes can be overridden.
Test Procedure from the W3C Draft
Quoted from the provision's informative document, informative/guidelines/text-and-wording/text-appearance/text-style-adjustable.md. It is the group's own procedure, not an editorial testing guide.
Procedure
For each block of text:
- Apply the highest level of change of each attribute specified in the provision.
- Check that the text is changed by the override.
Expected results
- #2 is true.
W3C Working Group Status
Open Questions Recorded in the Draft
The editors' own notes (:::ednote) in
guidelines/groups/text-and-wording/text-appearance/text-style-adjustable.md.
These are the questions the group has written down as unresolved —
not a summary of discussion written here.
If you are aware of research in this area, especially involving non-Latin scripts, please email public-agwg-comments@w3.org.
W3C Threads on This Provision
4 GitHub threads carrying 8 comments, fetched from w3c/wcag3 by the tracker. Titles, numbers and states are the threads' own.
What the Argument Is About
Whether user-selectable font family belongs in the standard at all, and whether "accessible typeface" can ever be stated as a requirement rather than advice.
Positions taken in the thread
LaZay opens #161 asking that font selection join the other user-adjustable properties in 1.4.8, noting publishers still ship serif paper fonts in digital products where they blur on screen, and that any offered families have to exist on the user's machine โ a harder implementation problem than other CSS overrides. LaurenceZaysser makes the same case in #340 as a gap rather than an enhancement: 1.4.4 Resize Text has no font-family equivalent, browsers and ebook reading systems already do this, and WCAG 2.2 is therefore not the full EAA cover it is claimed to be, since Annex I requires fonts of suitable shape. Proposes a new SC 1.4.14 Change font family with a sufficient technique naming OpenDyslexic.
Argues in #245 that a meaningful, testable normative standard covering all font use cases is out of reach, though blocks of body text might be a candidate. The reason is that line-height, letter-spacing, font-weight and font-size are all relative to decisions the font designer made, so two faces set at 16px and weight 400 rasterise at different real sizes and weights. Proposes CSS-level fixes โ a property to set x-height directly, already filed with the CSSWG, and line-height expressed against x-height โ and gives concrete targets: critical size is an x-height at least twice measured acuity height, lowercase aspect ratio under 1.5:1, baselines about 2.5 x-heights apart. Notes a century of research has produced little consensus beyond "blackletter fonts are hard to read".
In #245 in 2022, before the OpenDyslexic proposals in #161 and #340 were filed, argues that fonts like OpenDyslexic and Dyslexie are not actually useful, because they assume dyslexia is a visual problem when it is language-specific. Cites Marinus, Mostard et al., where increasing letter spacing on plain Arial produced the same benefit as Dyslexie, implying the gain comes from reduced crowding rather than glyph shape. Adds that dyslexia is almost unheard of in Korean, which is a clear language, so glyph-level remedies do not generalise across writing systems โ of which there are at least 40 common ones.
If CSS is not expressive enough for authors to declare these properties or for tools to query them from a rendered page, and font choice is effectively unlimited, a tester would have to run the numbers against every font an author picked โ complicated further by user agents and operating systems shipping their own slight variants of nominally identical fonts and doing substitutions. Pushes chaals directly: if the user agent does not supply an accessible font, does the site then fail in that user agent? Draws the line at information, advice and best practice being fine, while mandatory requirements built on the same evidence is where it gets interesting.
Where the user agent supplies the font, the requirement belongs on the user agent to offer accessible fonts. Research on this has existed for a long time, so publishing information about which fonts are more accessible โ and to whom, and when โ should not be beyond the group. Adds the author-side corollary: if you choose fonts and want accessible content, logic says you check whether the fonts you chose achieve that.
In #413, reads G183's "if there are not a large number of links" caveat as an implicit allowance for a different treatment in high link-density content such as wikis and glossaries. Argues G182's non-underlined alternatives โ blue bold, red italic โ are not reliably read as links, because user expectation is anchored to underlines. Proposes a Method under the adjustable text style guideline using text-decoration-style: dotted, with a demo file attached, to keep links perceivable while cutting visual clutter.
Agreed
- Font metrics are not comparable across families โ x-height ratio, stroke weight, kerning and leading are all designer choices with no standard, so nominal font-size and font-weight values do not describe what reaches the screen. Nobody in #245 disputed this.
- Publishing information and best practice about accessible typefaces is uncontroversial; only making it normative is contested.
Still open
- Whether a font-family override requirement can work given the font must already be installed on the user's machine โ LaZay raised the constraint and left it unresolved.
- Whether WCAG 2.2 actually covers the EAA's "suitable shape" language, which LaurenceZaysser says it does not; the parallel oversight is filed against the EPUB EAA mapping as epub-specs#2752.
- Where the requirement lands when the user agent supplies the font โ patrickhlauke's question to chaals about whether a site fails in a user agent that offers no accessible font was never answered.
- Whether OpenDyslexic should be named as a sufficient technique when Myndex's evidence says the benefit comes from spacing, not glyphs. The two threads never meet.
- hata6502's dotted-underline Method, which drew no responses.
Note
Volume is concentrated in one place. All eight comments sit in #245, and the three other issues โ #161, #340 and #413 โ are unanswered bodies, so their proposals have neither support nor pushback on record. #245's own discussion is also aged: the substantive exchange is from 2022, with mraccess77 adding reading links in 2025 and no reply since.
- #161 1.4.8 Visual Presentation += Fonts open 0 comments · updated 2026-04-16
- #245 Consider adding guideline for Accessible Type Faces open 8 comments · updated 2026-05-02
- #340 1.4 Distinguishable - Missing Change of font family open 0 comments · updated 2026-04-02
- #413 Alternative link style method for high link-density content (addition to Guideline 1.4 โ Adjustable text style) open 0 comments · updated 2026-03-29
WCAG 2.2 Criteria That Map Here
From this site's reviewed WCAG 2.2 → WCAG 3 map. The map is an interpretation, not a W3C mapping: W3C has not published one yet.
W3C Raw Source Text
Verbatim from guidelines/groups/text-and-wording/text-appearance/text-style-adjustable.md · informative document: informative/guidelines/text-and-wording/text-appearance/text-style-adjustable.md
The presentation of text style properties can be adjusted, without loss of content or functionality, to meet the @@ [values to be determined] for: * typeface * font width * text decoration * capitalization * automatic end-of-line hyphenation :::note The requirement is that the text is manipulable and the style attributes can be overridden. ::: :::except-when * the text style property is hard-coded, such as raw text that is capitalized or hyphenated. ::: :::ednote If you are aware of research in this area, especially involving non-Latin scripts, please email public-agwg-comments@w3.org. :::