Parent-Child Required Roles Quick Reference

A quick reference guide highlighting common parent-child role requirement issues frequently flagged by our clients. Each role in this table is linked to its corresponding section in the WAI-ARIA specification to enable you to dig deeper.

If you can't find the flagged role listed below, look in the WAI-ARIA document for more information.

Not sure where to find the flagged role? Review our article Fixing ARIA Parent-Child Issues.

Parent Role	Required Child Role
`list`	`listitem`
`radiogroup`	`radio`
`tablist`	`tab`
`table`	`row`
`rowgroup`	`row`
`row`	One or more of: `cell` `gridcell` `columnheader` `rowheader`
`menu`	At least one of: `group` → `menuitem` `group` → `menuitemradio` `group` → `menuitemcheckbox` `menuitem` `menuitemcheckbox` `menuitemradio`
`combobox`	At least one of: `listbox` `tree` grid dialog
`listbox`	At least one of: `group` → `option` `option`
`feed`	`article`
`grid`	At least one `row`, which must contain one or more `cell` or `gridcell` roles.
`tree`	One or more `treeitem` roles.
`treegrid`	One or more row roles, which must contain gridcell or rowheader roles.

Learn More

Using WAI-ARIA from W3C
WAI-ARIA Roles from mdn docs
Understanding Information and Relationships (A) from WCAG

DubBot Flags:

Certain ARIA roles must contain particular children
Ensures elements with an ARIA role that require child roles contain them
Certain ARIA roles must be contained by particular parents
Ensures elements with an ARIA role that require parent roles are contained by them

If you have questions, please contact our DubBot Support team via email at help@dubbot.com or via the blue chat bubble in the lower right corner of your screen. We are here to help!

Related Articles

Learn More