ARIA Role Reference
Search and browse the full WAI-ARIA 1.2 role catalogue — descriptions, required attributes, owned elements, and HTML equivalents.
92 roles in WAI-ARIA 1.2
commandAbstract superclass for widgets that perform an action but do not receive input.
Supported attributes
Inherits from
compositeAbstract superclass for widgets that contain navigable descendants or owned elements.
Supported attributes
Inherits from
inputAbstract superclass for widgets that allow user input.
Supported attributes
Inherits from
landmarkAbstract superclass for regions that are major navigation landmarks.
Supported attributes
Inherits from
rangeAbstract superclass for input representing a range of values.
Supported attributes
Inherits from
roletypeThe base role for all other roles — provides core properties all roles inherit.
Supported attributes
sectionAbstract superclass for document sections that are contained in other sections.
Supported attributes
Inherits from
sectionheadAbstract superclass for elements that label or summarise a section.
Supported attributes
Inherits from
selectAbstract superclass for composites that support single or multiple selection.
Supported attributes
Inherits from
structureAbstract superclass for document structural elements.
Inherits from
widgetAbstract superclass for interactive user interface components.
Inherits from
windowAbstract superclass for browser or app windows.
Supported attributes
Inherits from
article<article>A section of a page that could stand alone, e.g. a blog post or forum entry.
Supported attributes
Inherits from
blockquote<blockquote>Content quoted from another source.
Supported attributes
Inherits from
caption<caption>, <figcaption>Visible label or explanatory text for a figure, table, or grid.
Required context (parent)
Inherits from
cell<td>A cell in a tabular container.
Supported attributes
Required context (parent)
Inherits from
code<code>A fragment of computer code.
Inherits from
columnheader<th scope="col">A header cell in a column that provides a label for the column.
Supported attributes
Required context (parent)
Inherits from
definition<dd>A definition of a term or concept.
Supported attributes
Inherits from
deletion<del>Content that has been removed from the document.
Inherits from
document<html>, <body>An element containing content that assistive technology users may want to navigate in reading mode.
Supported attributes
Inherits from
emphasis<em>Inline text with stress emphasis.
Inherits from
figure<figure>A perceivable section of content, usually with a caption.
Supported attributes
Inherits from
generic<div>, <span>A nameless container element with no semantic meaning, equivalent to a plain div.
Inherits from
grid<table> (interactive)A composite widget with rows and columns, like a spreadsheet or data table with interactive cells.
Supported attributes
Required owned elements
Inherits from
gridcell<td> (in interactive grid)A cell in a grid or treegrid.
Supported attributes
Required context (parent)
Inherits from
group<fieldset>, <details>, <optgroup>A set of user interface objects that are not intended to be included in a page table of contents.
Supported attributes
Inherits from
heading<h1>–<h6>A heading for a section of the page, indicating hierarchy.
Required attributes
Supported attributes
Inherits from
img<img>A container for a collection of elements that form an image.
Supported attributes
Inherits from
insertion<ins>Content that has been added to the document.
Inherits from
list<ul>, <ol>A section containing listitem elements.
Supported attributes
Required owned elements
Inherits from
listitem<li>A single item in a list.
Supported attributes
Required context (parent)
Inherits from
mark<mark>Text that is marked or highlighted for reference.
Inherits from
math<math>Content that represents a mathematical expression.
Supported attributes
Inherits from
meter<meter>A scalar measurement within a known range, e.g. disk usage.
Required attributes
Supported attributes
Inherits from
noneAn element whose implicit ARIA semantics are exposed to the accessibility API as nothing (synonym for "presentation").
Inherits from
noteA section whose content is parenthetical or ancillary to the main content.
Supported attributes
Inherits from
paragraph<p>A paragraph of content.
Inherits from
presentationAn element whose implicit ARIA semantics are removed and will not be mapped to the accessibility tree.
Inherits from
row<tr>A row of cells in a tabular container.
Supported attributes
Required owned elements
Required context (parent)
Inherits from
rowgroup<tbody>, <thead>, <tfoot>A group of rows in a tabular container.
Required owned elements
Required context (parent)
Inherits from
rowheader<th scope="row">A header cell in a row that provides a label for the row.
Supported attributes
Required context (parent)
Inherits from
strong<strong>Content with strong importance, seriousness, or urgency.
Inherits from
subscript<sub>Inline text displayed lowered with smaller type, used for typographical conventions.
Inherits from
superscript<sup>Inline text displayed raised with smaller type, used for typographical conventions.
Inherits from
table<table>A section containing data arranged in rows and columns, similar to an HTML table.
Supported attributes
Required owned elements
Inherits from
term<dt>A word or phrase with a corresponding definition.
Supported attributes
Inherits from
time<time>A span representing a specific point or range of time.
Inherits from
toolbarA collection of commonly used function buttons or controls.
Supported attributes
Inherits from
tooltipA contextual popup that displays a description for an element.
Supported attributes
Inherits from
banner<header> (top-level)A site-oriented content area, typically at the top of the page, e.g. the site logo, main navigation, or search.
Supported attributes
Inherits from
complementary<aside>A section of the document that supports but is separable from the main content.
Supported attributes
Inherits from
contentinfo<footer> (top-level)The footer of the page, typically containing copyright information, legal notices, or contact links.
Supported attributes
Inherits from
form<form> (with accessible name)A landmark region that contains a collection of items and objects that, as a whole, combine to create a form.
Supported attributes
Inherits from
main<main>The main content of a document.
Supported attributes
Inherits from
navigation<nav>A collection of navigational elements (usually links) for navigating the document or related documents.
Supported attributes
Inherits from
region<section> (with accessible name)A perceivable section containing content relevant to a specific purpose, labelled so users can navigate to it.
Supported attributes
Inherits from
search<search>A landmark containing the site search functionality.
Supported attributes
Inherits from
alertAn important, usually time-sensitive message. Announced immediately by screen readers.
Supported attributes
Inherits from
logA type of live region where new information is appended in a meaningful order, e.g. a chat log.
Supported attributes
Inherits from
marqueeA type of live region where non-essential information changes frequently, e.g. a stock ticker.
Supported attributes
Inherits from
statusA live region containing advisory information for the user, with lower urgency than an alert.
Supported attributes
Inherits from
timerA numerical counter indicating elapsed or remaining time.
Supported attributes
Inherits from
button<button>An interactive element activated by a user to trigger an action.
Supported attributes
Inherits from
checkbox<input type="checkbox">A checkable input that has three possible states: true, false, or mixed.
Required attributes
Supported attributes
Inherits from
combobox<select> (editable combination)An input widget that can show a listbox popup with options. Combines a text input with a dropdown.
Required attributes
Supported attributes
Inherits from
link<a href>An interactive reference to an internal or external resource that, when activated, causes navigation.
Supported attributes
Inherits from
listbox<select>A widget that allows the user to select one or more items from a list.
Supported attributes
Required owned elements
Inherits from
menuA list of choices offered to the user, like a context menu or action menu.
Supported attributes
Required owned elements
Inherits from
menubarA horizontal menu bar, commonly found at the top of desktop-like application interfaces.
Supported attributes
Required owned elements
Inherits from
menuitemAn option in a menu.
Supported attributes
Required context (parent)
Inherits from
menuitemcheckboxA menuitem with a checkable state.
Required attributes
Supported attributes
Required context (parent)
Inherits from
menuitemradioA checkable menuitem in a group where only one item can be checked at a time.
Required attributes
Supported attributes
Required context (parent)
Inherits from
option<option>A selectable item in a listbox.
Supported attributes
Required context (parent)
Inherits from
progressbar<progress>An element that displays the progress status of a task.
Supported attributes
Inherits from
radio<input type="radio">A checkable input in a group where only one can be checked at a time.
Required attributes
Supported attributes
Inherits from
radiogroup<fieldset> (radio)A group of radio buttons.
Supported attributes
Required owned elements
Inherits from
scrollbarA graphical object that controls the scrolling of content within a viewing area.
Required attributes
Supported attributes
Inherits from
searchbox<input type="search">A type of textbox intended for specifying search criteria.
Supported attributes
Inherits from
separator<hr>A divider that separates and distinguishes sections of content. When focusable, acts as a splitter.
Supported attributes
Inherits from
slider<input type="range">An input where the user selects a value from within a given range.
Required attributes
Supported attributes
Inherits from
spinbutton<input type="number">A form of range that expects the user to select from among discrete choices.
Supported attributes
Inherits from
switchA type of checkbox that represents an on/off value, as opposed to checked/unchecked.
Required attributes
Supported attributes
Inherits from
tabA grouping label providing a mechanism for selecting the tab content that is to be rendered.
Supported attributes
Required context (parent)
Inherits from
tablistA list of tab elements, which are references to tabpanel elements.
Supported attributes
Required owned elements
Inherits from
tabpanelA container for the resources associated with a tab.
Supported attributes
Inherits from
textbox<input type="text">, <textarea>A type of input that allows free-form text as its value.
Supported attributes
Inherits from
treeA hierarchical list widget where some items can be expanded to reveal child items.
Supported attributes
Required owned elements
Inherits from
treegridA grid whose rows can be expanded and collapsed in the same manner as a tree.
Supported attributes
Required owned elements
Inherits from
treeitemAn option item of a tree. Can be expanded/collapsed if it contains child items.
Supported attributes
Required context (parent)
Inherits from
alertdialogA type of dialog that contains an alert message and where the initial focus goes to an element within the dialog.
Required attributes
Supported attributes
Inherits from
dialog<dialog>A dialogue box or other sub-window floating above the application.
Supported attributes
Inherits from