For AI agents and LLMs: a machine-readable index is available at llms.txt. A plain-Markdown version of any documentation page is available by appending .md to its URL.
Skip to main content

Labels or Instructions (3.3.2)

Form fields and interactive controls must have labels or instructions that describe the expected input.

WCAG Reference

Applies to: WCAG 2.0, WCAG 2.1, WCAG 2.2 Introduced in: WCAG 2.0 | Level: A | Read the official specification →

What this rule checks​

The scanner verifies that form inputs have visible labels programmatically associated with the control, and that fields requiring specific formats include instructions.

Why it matters​

Without labels, screen-reader users hear only "edit text" or "combo box" with no indication of what information is expected. Sighted users benefit from persistent labels too, especially when revisiting a partially completed form.

Common failure patterns​

  • input fields that rely on placeholder text as the only label (disappears on focus)
  • labels that exist visually but are not associated with the input (for/id mismatch)
  • date or phone fields with no format hint (e.g., "MM/DD/YYYY")
  • groups of related fields (address, payment) with no group label or <fieldset>

Remediation guidance​

  • add a visible <label> element with a matching for attribute for every form control
  • include format instructions or examples near the field (e.g., "Enter date as MM/DD/YYYY")
  • use <fieldset> and <legend> for logically grouped fields
  • never use placeholder as a substitute for a visible label

Terminal First Testing With Kane CLI

Natural language browser & mobile app tests right from terminal.

×
Schedule Your Personal Demo
Kane CLI terminal

Help and Support

Related Articles