Web Tools

A11y Annotator

All tools

Audit a block of markup for the accessibility gaps reviewers flag first, with a patched copy to start from.

How it works

Four simple steps

1

Paste HTML

Add a snippet or full page markup to audit.

2

Run accessibility checks

Catch missing alt, labels, heading skips, and empty controls.

3

Review WCAG tags

Each finding maps to a practical criterion note.

4

Preview simple fixes

Copy suggested aria-label or alt patches.

A11y Annotator

About A11y Annotator

A designer hands over a new signup form and the pull request is due today. Before it ships, you want to know whether the icon buttons announce anything, whether every input has a label, and whether the headings jump from h1 to h4. Paste the markup here and you get that list in seconds.

The annotator parses your HTML with the browser's DOMParser and runs checks mapped to WCAG success criteria: images without alt, alt text that is only a file name, form controls with no accessible name or just a placeholder, nameless buttons and links, generic link text such as "click here", skipped heading levels, a missing or repeated h1, no main landmark, untitled iframes, duplicate ids, positive tabindex, tables without th cells and autoplaying media. Each finding is marked as a failure or a warning, and the score out of 100 drops by 18 per failing check and 8 per warning.

The right-hand panel holds an auto-fixed copy of your markup. It adds alt attributes (empty for images whose class or src suggests decoration, a TODO placeholder otherwise), aria-label values guessed from placeholders, names or icon classes, and a generic title on iframes. Treat those as scaffolding: an aria-label of "Search" guessed from a bi-search icon is fine, but "TODO describe this image" has to be rewritten before release. Color contrast is not part of this audit, so run your palette through the color contrast ratio checker as well, and catch markup errors with the HTML validator.

The pasted markup becomes an inert document inside this tab. Scripts in it never run, and images or iframes it references are not requested.

Keyboard shortcut

Ctrl Enter - Run tool
FAQ

Frequently asked questions

See all FAQs

Answers for this tool. For site-wide help, open the FAQ hub.

Each failing check removes 18 points and each warning 8, no matter how many elements it covers. A check with five unlabeled inputs costs the same as one with a single input, so read the detail list rather than relying on the number alone.

Yes. Fragments work fine, but they usually trigger a missing main landmark failure and a missing h1 warning because those belong to the page layout. Ignore those two findings when you are checking a single component.

Images whose class or src contains words like icon, decor, spacer, bg- or background are treated as decorative and get alt="". Every other image receives a TODO placeholder so you are forced to write a real description.

View more FAQs

Related tools

View all

Bundle Size Estimator

Compare approximate gzip sizes for popular npm packages offline.

Open

Import Cost Estimator

Estimate approximate import cost from pasted import lines and package names.

Open

URL Parser

Break down any URL into parts.

Open

URL Builder

Build URLs with query params.

Open

Explore 321 free tools

Everything you need as a developer, marketer or creator - in one beautiful place.

Browse all tools