Buttons must have discernible text

Log in (Premium content) Request a demo

Rule Description

Buttons must have discernible text that clearly describes the destination, purpose, function, or action for screen reader users.

The Algorithm, in Simple Terms

Checks all buttons to ensure that they have a discernable, accessible name

Why this is Important

Screen reader users are not able to discern the purpose of button that has no accessible name.

How to Fix the Problem

Ensure that each <button> element and elements with role="button" have one of the following characteristics:

  • Inner text that is discernible to screen reader users.
  • Non-empty aria-label attribute.
  • aria-labelledby pointing to element with text which is discernible to screen reader users (i.e. not display: none; or aria-hidden="true".
  • role="presentation" or role="none" (ARIA 1.1) and is not in tab order (tabindex="-1").

Ensure that <input type="button">s have one of the following characteristics:

  • Non-empty value attribute.
  • Non-empty aria-label attribute.
  • aria-labelledby pointing to element with text which is discernible to screen reader users (i.e. not display: none; or aria-hidden="true".

Ensure that <input type="submit">, <input type="reset"> have one of the following characteristics:

  • Non-empty aria-label attribute.
  • aria-labelledby pointing to element with text which is discernible to screen reader users (i.e. not display: none; or aria-hidden="true".
  • Non-empty or unspecified value attribute. Browsers will give reset and submit buttons a default value so long as the value attribute is not specified.

Compliance Data & User Impact

User Impact: Critical
Disabilities Affected:
  • Blindness
  • Deafblindness
Issue Type:
  • WCAG 2.0 (A): MUST
  • Section 508: MUST
  • WCAG 2.1 (A): MUST
WCAG Success Criteria:
  • 4.1.2 Name, Role, Value
Section 508 Guidelines:
  • 1194.22 (a) Text equivalent for non-text elements

Related Deque University Course Pages

Additional Information

Relevant Technologies:
  • HTML 4
  • HTML5
  • ARIA
Test Reliability: Automated testing is possible, with high accuracy
Rule ID: button-name