Developer rule guides

Fix common axe-core accessibility errors

Short, practical pages for the rule IDs developers paste from automated accessibility scans. Each guide explains the impact, WCAG mapping, failing markup, fixed code, and what still needs human review.

color-contrastWCAG 1.4.3

Fix color-contrast axe errors

Text does not have enough contrast against its background for many low-vision users to read it comfortably.

Read rule guide
image-altWCAG 1.1.1

Fix image-alt axe errors

An image is missing an alternative text decision, so screen reader users may lose information or hear a raw filename.

Read rule guide
labelWCAG 1.3.1, 3.3.2, 4.1.2

Fix label axe errors

A form control has no programmatic label, so assistive technology cannot announce what input is expected.

Read rule guide
button-nameWCAG 4.1.2

Fix button-name axe errors

A button has no accessible name, so assistive technology users cannot tell what action it performs.

Read rule guide
link-nameWCAG 2.4.4, 4.1.2

Fix link-name axe errors

A link has no accessible name, making its destination or purpose unclear to assistive technology users.

Read rule guide
aria-required-attrWCAG 4.1.2

Fix aria-required-attr axe errors

An ARIA role is missing attributes required for that role, so the component may be exposed incorrectly.

Read rule guide
html-has-langWCAG 3.1.1

Fix html-has-lang axe errors

The page does not declare its default language, so screen readers may choose the wrong pronunciation rules.

Read rule guide
document-titleWCAG 2.4.2

Fix document-title axe errors

The document has no useful title, making browser tabs, history, and assistive navigation harder to understand.

Read rule guide
meta-viewportWCAG 1.4.4, 1.4.10

Fix meta-viewport axe errors

The viewport configuration can block zooming or responsive layout, making content harder to read on mobile.

Read rule guide
aria-valid-attrWCAG 4.1.2

Fix aria-valid-attr axe errors

An ARIA attribute is misspelled or invalid, so browsers and assistive technology may ignore it.

Read rule guide