<!--
{
  "availability" : [
    "macOS: 10.7.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSAccessibility-swift.struct/Notification/announcementRequested",
  "metadataVersion" : "0.1.0",
  "role" : "Type Property",
  "symbol" : {
    "kind" : "Type Property",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:@NSAccessibilityAnnouncementRequestedNotification"
  },
  "title" : "announcementRequested"
}
-->

# announcementRequested

This notification posts when an app needs to make an announcement to the user. If VoiceOver is enabled, it’s presented via speech and/or braille. Otherwise, it does nothing.

```
static let announcementRequested: NSAccessibility.Notification
```

## Discussion

This notification requires a `userInfo` dictionary with the key [`announcement`](/documentation/AppKit/NSAccessibility-swift.struct/NotificationUserInfoKey/announcement) and a localized string containing the announcement. To help an assistive app determine the importance of the announcement, add the appropriate [`priority`](/documentation/AppKit/NSAccessibility-swift.struct/NotificationUserInfoKey/priority) to the `userInfo` dictionary.

```swift
let announcement = "The input was invalid."
NSAccessibility.post(
    element: NSApp.mainWindow as Any,
    notification: .announcementRequested,
    userInfo: [
        .announcement: announcement,
        .priority: NSAccessibilityPriorityLevel.medium.rawValue
    ])
```

If you need more control over how your announcements are pronounced, such as including punctuation or setting the spoken language, you can use <doc://com.apple.documentation/documentation/Foundation/NSAttributedString>. For a list of available string attributes, see <doc://com.apple.documentation/documentation/Foundation/NSAttributedString/Key>.

```swift
let announcement = NSAttributedString(
    string: "pain",
    attributes: [.accessibilityLanguage: "fr"]
)
NSAccessibility.post(
    element: NSApp.mainWindow as Any,
    notification: .announcementRequested,
    userInfo: [
        .announcement: announcement,
        .priority: NSAccessibilityPriorityLevel.medium.rawValue
    ])
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)