missing-group-label

Description

Groups of fields must have a visible label to ensure that users, including those using assistive technologies, can understand the context and purpose of the grouped fields. This rule aligns with WCAG Success Criterion 3.3.2 (Labels or Instructions), which requires that labels or instructions are provided when content requires user input.

The missing-group-label rule ensures that groups of fields, such as those wrapped in a <fieldset>, are accompanied by a visible label (e.g., using a <legend> element). This helps users comprehend the relationship between the fields and the overall structure of the form.

Examples

In the following example, a group of fields is created using the <fieldset> element, but no visible label is provided. This violates the missing-group-label rule because users cannot determine the purpose of the grouped fields.

In the following corrected example, a visible label is added using the <legend> element, providing context for the grouped fields:

How to fix?

To fix violations of the missing-group-label rule, follow these steps:

1. Identify all groups of fields on your webpage that lack a visible label.
2. Use the <legend> element within a <fieldset> to provide a visible label for the group.
3. Ensure the label clearly describes the purpose or context of the grouped fields.
4. Test the form with assistive technologies to confirm that the label is accessible and properly conveyed.

Reference

WCAG Success Criterion 3.3.2: Labels or Instructions