---
title: Element.ariaLabel
slug: Web/API/Element/ariaLabel
tags:
  - API
  - Property
  - Reference
  - ariaLabel
  - AriaAttributes
  - AriaMixin
  - Element
browser-compat: api.Element.ariaLabel
---
{{DefaultAPISidebar("DOM")}}

The **`ariaLabel`** property of the {{domxref("Element")}} interface reflects the value of the [`aria-label`](/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute) attribute, which defines a string value that labels the current element.

## Syntax

    var ariaLabel = element.ariaLabel;
    element.ariaLabel = ariaLabel

### Value

A {{domxref("DOMString")}}.

## Examples

In this example the `aria-label` attribute on the element with an ID of `close-button` is set to "Close". Using `ariaLabel` we update the value to "Close dialog".

```html
<button aria-label="Close" id="close-button">X</button>
```

```js
let el = document.getElementById('close-button');
console.log(el.ariaLabel); // "Close"
el.ariaLabel = "Close dialog"
console.log(el.ariaLabel); // "Close dialog"
```

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}
