Missing Fieldset Description Check
Description
The “Missing Fieldset Description Check” evaluates whether there is any <fieldset>
element without a description (i.e., a <legend>
element within).
Example outcome
I found 1 <fieldset>
element without any description.
Impact
- Visual Impairments: Screen readers use
<legend>
to provide context for grouped form elements. Without it, the user may not understand the purpose of the fields. - Motor Impairments: Assistive tech users navigating forms with voice or switch input benefit from semantic structure; a missing legend impairs navigation.
- Cognitive Disabilities: Users may be confused without proper grouping and labeling, leading to input errors or form abandonment.
Fixes
To address <fieldset>
elements missing description:
- Locate the
<fieldset>
element without a description. - Add a clear, concise
<legend>
element that describes the group’s purpose inside the fieldset.
Resources
- WCAG 2.2: Understanding Success Criteria 1.3.1
- WCAG 2.2: Understanding Success Criteria 3.3.2
- WCAG 2.2 Techniques: Technique H71: Providing a description for groups of form controls using fieldset and legend elements
- WebAIM: Semantic Structure: Regions, Headings, and Lists
- WebAIM: Creating Accessible Forms