Skip to main content

Accessibility issue library

Turn a scanner finding into a source-level fix.

Each guide explains one common issue, shows tested evidence where automation can help, and separates a clean re-scan from the human review still required.

Find issues on a live page

Tested repair guides

Start with the finding, then trace it to the source.

A scanner can narrow the work. It cannot decide whether the whole experience is understandable or whether a website conforms to WCAG.

Forms

Form labels and unlabelled inputs

See why placeholders are not dependable labels, compare a tested failing and passing fixture, then repair the shared form source.

Fix unlabelled form fields

Readability

Colour contrast for text

See a measured low-contrast example, the repaired colour value, what axe can detect and what still needs visual review.

Repair low-contrast text

Images

Missing and useful alt text

See a tested missing-alt failure, decide whether an image is meaningful or decorative, then repair and re-check the source.

Write useful image alternatives

Structure

Heading order and page hierarchy

See a tested skipped-level finding, separate semantic rank from visual size, then repair and review the rendered outline.

Repair heading order

Keyboard

Visible keyboard focus

See why an automated check can miss hidden focus, repair the indicator, then prove the full journey with Tab and Shift+Tab.

Make keyboard focus visible

Navigation

Link purpose and descriptive text

See an unnamed link fail while vague text passes automation, then repair the accessible name and review whether each destination is clear.

Write descriptive link text

Semantics

Invalid ARIA attributes

See an invented ARIA name fail a controlled check, prefer native HTML, then repair and test the interaction behind the attribute.

Repair invalid ARIA attributes

Find

Run the rendered page and use the affected element and rule to locate the real component, template or content source.

Fix

Change the source rather than masking the symptom. Shared failures usually belong in a shared component, theme or app block.

Verify

Re-scan the same page, then complete the keyboard, zoom, screen-reader or visual checks automation cannot settle.

Start with one page people need to use.

ClearSite is diagnostic. It helps you find, fix and re-check machine-detectable issues; it does not determine conformance or provide legal advice.

Run the free scan