WCAG 3.3.1 — Error Identification — form errors not identified
When people fill out forms on your website and make errors, the system isn't clearly telling them what went wrong. Users with disabilities may not be able to identify or understand the errors, preventing them from completing important government services. Under ADA Title II, form errors must be clearly identified and explained.
Who Is Affected
Screen reader users who cannot see visual error indicators, users with cognitive disabilities who need clear error explanations, users with low vision who may miss subtle error styling, and users with color blindness who cannot distinguish error colors from normal text.
What This Means
When a user submits a form with errors (missing required fields, invalid email format, etc.), the website must clearly identify which fields have problems and describe what's wrong. Simply highlighting a field in red or showing a generic "Please fix errors" message doesn't meet accessibility requirements.
Errors must be identified in text that assistive technology can read, associated with the specific form fields that have problems, and provided in a way that doesn't rely solely on color or visual cues.
Fix: CMS / Theme
Most form error identification issues stem from the theme or form plugin not providing accessible error messages by default.
For Joomla:
- Go to Components → Contact (or Forms extension if using third-party forms)
- Check your form's error handling settings
- Ensure error messages include specific field names and clear descriptions
- Verify that
aria-describedbyattributes link error messages to their fields - Test that error messages appear in the page's heading structure or are announced to screen readers
For WordPress:
- Go to the form plugin settings (Contact Form 7, Gravity Forms, etc.)
- Enable accessible error reporting in the plugin options
- Customize error message templates to include:
- The field name that has the error
- A clear description of what's wrong
- Instructions on how to fix it
- Ensure error messages are programmatically associated with form fields
Common fixes across platforms:
- Error messages should appear above the form or at the top of the page
- Each error message should identify the specific field and explain the problem
- Use
aria-describedbyto connect error text with form fields - Provide error summaries that list all problems in one place
Fix: Content Editor
If you're using simple contact forms or embedded forms where you can edit the error messages:
- Locate the form's error message settings in your editor
- Replace generic messages like "Error" or "Required" with specific descriptions:
- Instead of: "Required"
- Use: "Email address is required"
- For validation errors, explain what format is expected:
- Instead of: "Invalid"
- Use: "Email address must include @ symbol (example: name@example.com)"
- Test the form by submitting it with errors to verify messages are clear and specific
Standard Reference
WCAG 2.1 Success Criterion 3.3.1 — Error Identification, Level A
If an input error is automatically detected, the item that is in error is identified and the error is described to the user in text.
- W3C Understanding SC 3.3.1
- WCAG Technique G83 — Text descriptions for required fields in error
- WCAG Technique G85 — Text description when input falls outside required format
- WCAG Technique SCR18 — Client-side validation and error notification
- WCAG Technique ARIA21 — Using aria-describedby for error messages
- WCAG Failure F82 — Visual formatting alone to indicate required fields
Check if your government website has this issue
OctoComply scans your website and documents for WCAG 2.1 AA violations. The free tier covers up to 10 pages.
Run a Free Scan