---
sourceDocument: Xanadu API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# spAriaUtil - Client

# spAriaUtil - Client {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

The spAriaUtil API provides methods to show messages on a screen reader.

This API is an angular service that you can use in Service Portal widget client scripts.

## spAriaUtil - sendLiveMessage(String message) {#ariaid-title2}

Announce a message to a screen reader.
The sendLiveMessage() method injects text into an aria-live region on
the page. The default setting for an aria-live region is `assertive`, which
means that messages are announced immediately. This can annoy and confuse users if used too
frequently.
{#SPAU-sendLiveMessage_S__table_rb1_1wl_pz__entry__3}

| Name | Type | Description |
|-|-|-|
| message | String | The message to be shown. |
[Table 1. Parameters]

{#SPAU-sendLiveMessage_S__table_rb1_1wl_pz} {#SPAU-sendLiveMessage_S__table_sb1_1wl_pz__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 2. Returns]

{#SPAU-sendLiveMessage_S__table_sb1_1wl_pz}  

    function(spAriaUtil) {
      /* widget controller */

      spAriaUtil.sendLiveMessage('Hello world!');
    }