Accessibility Checklists

Accessible Tag Group Checklist (WCAG)

Every Tag Group rule that WCAG 2.2, WAI-ARIA or the APG backs, in one checklist, with the success criteria behind each rule and their level.

Here's every rule for the Tag Group that WCAG 2.2, WAI-ARIA or the APG backs, in one list you can work through when you build or review one. Each row names the WCAG 2.2 success criteria behind its rule, with their level, and links to the rule's table on its layer's page, where we explain why it's there. A rule that rests on WAI-ARIA or the APG alone says "None".

We build this list from the Tag Group's checklists, so it always matches them. It leaves out the rules that rest only on HTML and the ones that are our own, so you'll find every rule in the Tag Group's checklist.

UI rules

RuleLevelRequirementWCAG 2.2Basis
tag-group/wrapMustTags wrap onto as many rows as they need, with no horizontal scroll at 320px wide1.4.10 Reflow (AA)WCAG 1.4.10 (AA)
tag-group/row-gapMustRows sit at least 24px minus the tag's height apart, and 44px minus it on a touch screen, so no tag's hit area covers a tag on the next row2.5.8 Target Size (Minimum) (AA), 2.5.5 Target Size (Enhanced) (AAA)WCAG 2.5.8 (AA), 2.5.5 (AAA)
tag-group/contrastMustThe empty state's text has at least 4.5:1 against what's behind it, and its focus ring at least 3:11.4.3 Contrast (Minimum) (AA), 1.4.11 Non-text Contrast (AA)WCAG 1.4.3, 1.4.11 (AA)

UX rules

RuleLevelRequirementWCAG 2.2Basis
tag-group/listMustThe tags are a <ul> with one <li> per tag, which keeps its list role where its bullets are removed1.3.1 Info and Relationships (A)WCAG 1.3.1 (A)
tag-group/nameMustThe list has a name, from label or from a visible heading through aria-labelledby1.3.1 Info and Relationships (A)Open Components, beyond WCAG 1.3.1 (A)
tag-group/tab-stopsMustEach link and remove button is a stop in the tab order, in order, with no roving focus and no arrow keys2.1.1 Keyboard (A)WCAG 2.1.1 (A)
tag-group/focus-after-removeMustOnce a removed tag has gone, focus that was on it moves to the next tag's remove button, then fallbackFocus, then the previous tag's remove button, then the empty state, or the list when tags are left that can't be removed2.4.3 Focus Order (A)WCAG 2.4.3 (A)
tag-group/announce-removalShouldOnce a tag whose remove button was pressed has gone, a polite live region announces it, like "Bug removed"4.1.3 Status Messages (AA)WCAG 4.1.3 (AA)

AX rules

RuleLevelRequirementWCAG 2.2Basis
tag-group/role-and-nameMustIt can be found by its role and name, with getByRole("list", { name: "Labels" }), and each tag by its parts', like getByRole("button", { name: "Remove Bug" })4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A)

Sources

Copyright © 2026