<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.14.0 -",
    "tvOS: 10.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UserNotifications",
  "identifier" : "/documentation/UserNotifications/UNNotificationSettings",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "User Notifications"
    ],
    "preciseIdentifier" : "c:objc(cs)UNNotificationSettings"
  },
  "title" : "UNNotificationSettings"
}
-->

# UNNotificationSettings

The object for managing notification-related settings and the authorization status of your app.

```
class UNNotificationSettings
```

## Overview

A [`UNNotificationSettings`](/documentation/UserNotifications/UNNotificationSettings) object contains the current authorization status and notification-related settings for your app. Apps must receive authorization to schedule notifications and to interact with the user. Apps that run in CarPlay must similarly receive authorization to do so. Use this object to determine what notification-related actions your app can perform. You might then use that information to enable, disable, or adjust your app’s notification-related behaviors. Regardless of whether you take action, the system enforces your app’s settings by preventing denied interactions from occurring.

You don’t create instances of this class directly. Instead, call the [`getNotificationSettings(completionHandler:)`](/documentation/UserNotifications/UNUserNotificationCenter/getNotificationSettings(completionHandler:)) method of your app’s [`UNUserNotificationCenter`](/documentation/UserNotifications/UNUserNotificationCenter) object to get the current settings.

For more information about requesting authorization for user interactions, see [`UNUserNotificationCenter`](/documentation/UserNotifications/UNUserNotificationCenter).

## Topics

### Getting the Authorization Status

[`authorizationStatus`](/documentation/UserNotifications/UNNotificationSettings/authorizationStatus)

The app’s ability to schedule and receive local and remote notifications.

[`UNAuthorizationStatus`](/documentation/UserNotifications/UNAuthorizationStatus)

Constants indicating whether the app is allowed to schedule notifications.

### Getting Device-Specific Settings

[`notificationCenterSetting`](/documentation/UserNotifications/UNNotificationSettings/notificationCenterSetting)

The setting that indicates whether your app’s notifications appear in Notification Center.

[`lockScreenSetting`](/documentation/UserNotifications/UNNotificationSettings/lockScreenSetting)

The setting that indicates whether your app’s notifications appear on a device’s Lock screen.

[`carPlaySetting`](/documentation/UserNotifications/UNNotificationSettings/carPlaySetting)

The setting that indicates whether your app’s notifications appear in CarPlay.

[`alertSetting`](/documentation/UserNotifications/UNNotificationSettings/alertSetting)

The authorization status for displaying alerts.

[`badgeSetting`](/documentation/UserNotifications/UNNotificationSettings/badgeSetting)

The setting that indicates whether badges appear on your app’s icon.

[`soundSetting`](/documentation/UserNotifications/UNNotificationSettings/soundSetting)

The authorization status for playing sounds for incoming notifications.

[`criticalAlertSetting`](/documentation/UserNotifications/UNNotificationSettings/criticalAlertSetting)

The authorization status for playing sounds for critical alerts.

[`announcementSetting`](/documentation/UserNotifications/UNNotificationSettings/announcementSetting)

The setting that indicates whether Siri can announce your app’s notifications.

[`scheduledDeliverySetting`](/documentation/UserNotifications/UNNotificationSettings/scheduledDeliverySetting)

The setting that indicates the system schedules the notification.

[`timeSensitiveSetting`](/documentation/UserNotifications/UNNotificationSettings/timeSensitiveSetting)

The setting that indicates the system treats the notification as time-sensitive.

[`UNNotificationSetting`](/documentation/UserNotifications/UNNotificationSetting)

Constants that indicate the current status of a notification setting.

### Getting Interface Settings

[`alertStyle`](/documentation/UserNotifications/UNNotificationSettings/alertStyle)

The type of alert that the app may display when the device is unlocked.

[`UNAlertStyle`](/documentation/UserNotifications/UNAlertStyle)

Constants indicating the presentation styles for alerts.

[`showPreviewsSetting`](/documentation/UserNotifications/UNNotificationSettings/showPreviewsSetting)

The setting that indicates whether the app shows a preview of the notification’s content.

[`UNShowPreviewsSetting`](/documentation/UserNotifications/UNShowPreviewsSetting)

Constants indicating the style previewing a notification’s content.

[`providesAppNotificationSettings`](/documentation/UserNotifications/UNNotificationSettings/providesAppNotificationSettings)

A Boolean value indicating the system displays a button for in-app notification settings.

### Instance Properties

[`directMessagesSetting`](/documentation/UserNotifications/UNNotificationSettings/directMessagesSetting)


---

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)