Interactive Element Names Available
Group: interactive-components • Guideline: control-information
Summary in Plain English
Every clickable or interactive element (buttons, links, form fields, tabs) must have a persistent visual and programmatic name so users know what it does.
Why It Matters
Users rely on labels to know what will happen when they click or tap. Screen readers need programmatic names to announce controls accurately.
Scope: When This Applies
The draft's own conditions, quoted from guidelines/groups/interactive-components/control-information/interactive-element-names-available.md.
Notes in the draft
Visible labels can be text or non-text, for instance icons.
Test Procedure from the W3C Draft
Quoted from the provision's informative document, informative/guidelines/interactive-components/control-information/interactive-element-names-available.md. It is the group's own procedure, not an editorial testing guide.
Procedure
For each interactive element:
- Confirm it has a visual label that describes the element.
- Confirm the visual label persists during use.
Expected results
- #1 and #2 are true.
Methods Suggested Upstream
Implementation methods listed in the informative document.
- Provide unique, descriptive text or image (icon) for each interactive element.
Recommended Practices (Upstream)
- To ensure clarity, pair an icon with a persistent visible text label, or only use a persistent visible text label.
- When an icon is the only visual label, provide a tooltip (hover label) with the text description.
W3C Working Group Status
The draft records no open editors' notes on this provision.
W3C Threads on This Provision
4 GitHub threads carrying 35 comments, fetched from w3c/wcag3 by the tracker. Titles, numbers and states are the threads' own.
⚠️ This summary is stale — comments landed after it was written.
What the Argument Is About
Whether the visual gap between a label and the control it labels can be written as a testable numeric requirement at all โ argued out on one 2019 thread while the issues about accessible names themselves have drawn a single reply between them.
Positions taken in the thread
Proposed "Label gaps" in #194: when one element acts as a label of another, the gap between them is no larger than twice the smaller of the labelled element's width or height, measurable with a browser ruler or a script comparing absolute positions. When textareas broke that formula he reworked it to four times the smaller dimension of the label itself, so an icon or short text label sets the budget rather than a large field. He cites repeated findings in his own user testing with low vision users โ drop-down menus on accessuse.eu and the incobs tablet tests โ while conceding the label-to-control pair catches only a subset of the proximity problem, and that the exception list may grow until the requirement is lost, as happened with target size.
Found the loophole immediately: a designer could make fields unnecessarily tall purely to buy leeway to push the label further away, conforming while defeating the point for low vision users. detlevhfischer answered "not likely to happen"; patrickhlauke replied that creative interpretations of normative text to do the minimum necessary to pass are routine. His broader position is that layout and design questions resist rigid binary pass/fail rules, that Apple's own iOS guidance is couched as could and should and Apple ignores it freely, and that this belongs in a non-normative best-practice note or at AAA rather than as a hard requirement. He also asked that the measurement drop mm for px to avoid reopening the CSS-versus-physical-units confusion, which detlevhfischer did immediately.
awkawk points to left-aligned label columns with aligned fields, where varying label lengths necessarily produce varying gaps, and argues this is common enough that the working group needs clear evidence before proposing a criterion against it โ this is not an absolute like page title or programmatic label association. He wants the goal stated first: at what magnification must the user see the full label and the full input, or the full label and part of the input, and what happens when the label is long. jake-abma checked with designers and reported back that almost all current forms would fail the proposed calculation, which he called too prescriptive for design aesthetics, and later that mixed 3x and 4x width-or-height measurements are simply too complicated for designers, developers and testers.
Answers awkawk that clear evidence only ever comes from research, and the group has a chicken-and-egg problem when practitioner experience outruns formal study. Cites the Understanding document for SC 3.3.2, which stated in 2008 that labels in close proximity assist screen magnifier users because field and label are more likely to be visible within the magnified area, plus technique G162 and two Nielsen Norman Group articles on closeness of actions to objects and form white space. Turns the evidence demand back on existing criteria by questioning whether page titles are still demonstrably useful when browsers truncate or hide them. Calls awkawk's own screenshot a prime example of the problem: a common pattern is not thereby a correct one.
patrickhlauke suggested a minimum built on reflow rather than ratios: the related element must be at least partly present in the viewport even at 320 CSS px width. jake-abma picked this up as the direction most likely to work โ label and input visible in a 320 CSS px viewport at the same time, easy to test, with exceptions. He also supplied its limits: whether the label is visible depends on how far you have scrolled, something can be inside the viewport and still too far to read, and desktop zoom tools push the label off to the right and force horizontal scrolling, so the desktop case stays unsolved.
alastc showed the formula failing a usable pattern โ the GOV.UK Design System text input with hint text between label and field, and again when an error message is inserted โ then proposed folding associated information into the definition of label, and a looser framing that two related things must be close to each other unless there is a programmatic relationship, with gestalt principles consulted for what close means. He intended the escape hatch to leave room for a future user agent that draws an arrow or indicator, and suggested the COGA task force's design guidance as the better home. patrickhlauke rejected both halves: if the requirement is visual then a programmatic relationship is irrelevant to a user who is not running AT that exposes it, shifting the burden to user agents is a cop-out, and since programmatic association is already required by 1.3.1 and usually 4.1.2, a criterion satisfiable by passing those is redundant. jake-abma agreed on widening, arguing all name-value pairs and many other related pairs deserve the same treatment.
In #890 (October 2026) mcking65 proposes removing the programmatically available requirement from this provision, rewording it as "Names (including labels) that identify the purpose of the interactive element are visually persistent", and moving programmatic names into Roles, values, states, properties available, reworded so those attributes are "reliably" programmatically determinable. His grounds are that visual and API testing are separate processes, often by separate testers, and that bugs are easier to route when a provision clearly concerns visual design or code. GreggVan objects that "reliably" cannot be defined to mean matching the visible label and is not an objective term, that names do not include labels โ labels have meant what is visible and names what is programmatically determinable โ and that the name often should say more than the label, as with ON/OFF buttons whose association is visually obvious. He asks the group to start from desired outcomes for users without vision, with good vision and with low vision (and cognitive needs if not covered elsewhere), then decide whether this is one requirement or two.
Agreed
- That proximity between related information matters for low vision and magnifier users was never disputed โ awkawk states plainly that the concept is clear and everyone can see how it impacts people, and mraccess77 cited the 2008 SC 3.3.2 Understanding text and G162, though patrickhlauke later still asked for hard proof that larger gaps are a problem for particular users. The disagreement is entirely about whether "how close is close enough" can be drawn as a line.
- The problem is not specific to form labels. patrickhlauke asked whether any two insufficiently close related elements cause the same problem for low vision and zoom users, and jake-abma agreed, extending it to all name-value pairs โ neither treated label-and-input as the natural boundary, though patrickhlauke added that taken to its conclusion this would mean mandating whitespace and layout for everything on a page, which he said would not fly.
- Measurement should use CSS px, not mm; detlevhfischer changed the draft on patrickhlauke's first comment.
- The first formula does not survive real components โ textareas break it (detlevhfischer), and hint text or an inserted error message between label and field break it (alastc). Both were conceded.
Still open
- Whether "Relationships detectable" must stay limited to programmatic relationships or could additionally require visually clear ones โ adampage raised this in #194 in May 2026, pointing at #175; patrickhlauke's only reply was that defining how to represent something visually "clearly" lands you in arbitrary graphic design statements. Nothing else followed.
- tallneil's #93: whether the provision should require labels to remain visible "at all times" or "in all states" so the label survives after a value is set, and whether it should say explicitly that a placeholder attribute or the first option in a select are not sufficient substitutes for a label. Opened June 2024, no replies.
- mraccess77's #184: whether a button's accessible name must carry its context โ an "Add" button beside a person's name is visually related but not programmatically โ and whether that is a failure of 1.3.1, of 2.4.6, or of neither. He notes buttons are unlike links in that they rarely sit inside a sentence and may act on a whole group of fields, so the link-context reasoning does not transfer, and asks where the line for buttons is drawn. Deferred from w3c/wcag#168 in 2016, still no replies.
- What magnification level any metric is meant to serve, and whether the target is seeing the full label plus the full input or only part of it โ awkawk's questions, never answered.
- Exceptions for table labels, row and column headers together, and legends that sit far from their fields โ raised by jake-abma citing mbgower's label-in-name issues. anevins12 asked in 2022 whether that meant spreadsheet-style grids or all tables and got no reply.
- Whether this belongs in WCAG as a normative requirement at all, or in COGA design guidance or a separate best-practice document โ raised by patrickhlauke and echoed by alastc.
- mcking65's #890: whether the visual label and the programmatic name should be separate requirements, with the programmatic part moved into Roles, values, states, properties available. GreggVan disputed the proposed wording and asked for user outcomes to be listed first; no further discussion yet.
Note
The activity is lopsided. 33 of the 34 comments sit on #194, and 30 of them were written in a two-week burst in March and April 2019; anevins12's 2022 question went unanswered and the thread was then dormant for four years until adampage revived it in May 2026. Of the issues that actually concern accessible names, tallneil's #93 and mraccess77's #184, itself a deferral from 2016, have never received a single reply, and mcking65's #890 from October 2026 has one, from GreggVan.
- #93 Input labels clarification open 0 comments · updated 2026-04-16
- #184 Button accessible name context open 0 comments · updated 2026-05-02
- #194 Draft SC "Label gaps" open 34 comments · updated 2026-10-26
- #890 Separate visual label and programmatic name requirements for interactive elements open 1 comment · updated 2026-10-03
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.
Related WCAG 2.2 criteria
On a neighbouring subject, but this provision doesn't replace them.
W3C Raw Source Text
Verbatim from guidelines/groups/interactive-components/control-information/interactive-element-names-available.md · informative document: informative/guidelines/interactive-components/control-information/interactive-element-names-available.md
Persistent names (including labels) that identify the purpose of the interactive element are visually and programmatically available. :::note Visible labels can be text or non-text, for instance icons. :::