required-fields-asterisk
Rule Severity : Moderate
Description
If you use asterisks (*) to indicate required fields, you must provide an instruction that explains their meaning. Without this instruction, users—especially those using screen readers—might not understand that a field is mandatory.
The required-fields-asterisk rule aligns with Web Content Accessibility Guidelines (WCAG) Success Criterion 3.3.2 (Labels or Instructions). This criterion ensures that you provide labels or instructions when content requires user input.
Examples
In the following example, the form uses an asterisk but does not explain what it represents.
In the following corrected example, an instruction clearly defines the asterisk before the user interacts with the form:
How to fix?
To fix violations of the required-fields-asterisk rule, follow these steps:
-
Identify all forms that use an asterisk or similar symbol to mark required fields.
-
Add a clear text instruction at the start of the form, such as “Fields marked with an asterisk (*) are required.”
-
Ensure the instruction appears before the first required field so users see it before they provide input.
-
Verify that the instruction is programmatically determinable and visible to all users.
Reference
- WCAG Success Criterion 3.3.2: Labels or Instructions
- WCAG Success Criterion 2.4.6: Headings and Labels
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!