The ariaDescription property of the Element interface reflects the value of the aria-description attribute, which defines a string value that describes or annotates the current element.


var ariaDescription = element.ariaDescription;
element.ariaDescription = ariaDescription


A DOMString.


In this example the aria-description attribute on the element with an ID of close-button is set to the string "A longer description of the function of this element". Using ariaDescription we can update the value.

<button aria-label="Close" aria-description="A longer description of the function of this element" id="close-button">X</button>
let el = document.getElementById('close-button');
console.log(el.ariaDescription); // "A longer description of the function of this element"
el.ariaDescription = "A different description"
console.log(el.ariaDescription); // "A different description"


Specification Status Comment
Accessible Rich Internet Applications (WAI-ARIA) 1.2
The definition of 'ariaDescription' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser