<!--
{
  "availability" : [
    "iOS: 2.0 -",
    "iPadOS: 2.0 -",
    "macCatalyst: 13.0 -",
    "macOS: 10.8.0 - 11.0.0",
    "tvOS: 9.0 -",
    "visionOS: 1.0 -",
    "watchOS: 2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Foundation",
  "identifier" : "/documentation/Foundation/NSUserNotification",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Foundation"
    ],
    "preciseIdentifier" : "c:objc(cs)NSUserNotification"
  },
  "title" : "NSUserNotification"
}
-->

# NSUserNotification

A notification that can be scheduled for display in the notification center.

```
class NSUserNotification
```

## Overview

When the system delivers a notification, information about when the notification was actually presented to the user (if at all) and other details are provided in the notification object. User applications can create [`NSUserNotification`](/documentation/Foundation/NSUserNotification) objects and register them with the [`NSUserNotificationCenter`](/documentation/Foundation/NSUserNotificationCenter) object to notify the user when an application requires attention.

### Threading Information

The [`NSUserNotificationCenter`](/documentation/Foundation/NSUserNotificationCenter) class and the `NSUserNotification` class are both thread safe.

## Topics

### Display Information

[`title`](/documentation/Foundation/NSUserNotification/title)

Specifies the title of the notification.

[`subtitle`](/documentation/Foundation/NSUserNotification/subtitle)

Specifies the subtitle of the notification.

[`informativeText`](/documentation/Foundation/NSUserNotification/informativeText)

The body text of the notification.

[`contentImage`](/documentation/Foundation/NSUserNotification/contentImage)

Image shown in the content of the notification.

[`identifier`](/documentation/Foundation/NSUserNotification/identifier)

A string that uniquely identifies a notification.

[`response`](/documentation/Foundation/NSUserNotification/response)

The response with which the user responded to a notification.

[`responsePlaceholder`](/documentation/Foundation/NSUserNotification/responsePlaceholder)

Optional placeholder string for inline reply field.

### Displayed Notification Buttons

[`hasActionButton`](/documentation/Foundation/NSUserNotification/hasActionButton)

A Boolean value that specifies whether the notification displays an action button.

[`actionButtonTitle`](/documentation/Foundation/NSUserNotification/actionButtonTitle)

Specifies the title of the action button displayed in the notification.

[`otherButtonTitle`](/documentation/Foundation/NSUserNotification/otherButtonTitle)

Specifies a custom title for the close button in an alert-style notification.

[`hasReplyButton`](/documentation/Foundation/NSUserNotification/hasReplyButton)

A Boolean value that specifies whether the notification displays a reply button.

### Delivery Timing

[`deliveryDate`](/documentation/Foundation/NSUserNotification/deliveryDate)

Specifies when the notification should be delivered.

[`actualDeliveryDate`](/documentation/Foundation/NSUserNotification/actualDeliveryDate)

The date this notification was actually delivered.

[`deliveryRepeatInterval`](/documentation/Foundation/NSUserNotification/deliveryRepeatInterval)

Specifies the date components that control how often a user notification is repeated.

[`deliveryTimeZone`](/documentation/Foundation/NSUserNotification/deliveryTimeZone)

Specify the time zone to interpret the delivery date in.

### Delivery Information

[`isPresented`](/documentation/Foundation/NSUserNotification/isPresented)

Specifies whether the user notification has been presented.

[`isRemote`](/documentation/Foundation/NSUserNotification/isRemote)

Specifies whether the remote was generated by a push notification.

[`soundName`](/documentation/Foundation/NSUserNotification/soundName)

Specifies the name of the sound to play when the notification is delivered.

### User Notification Activation Method

[`activationType`](/documentation/Foundation/NSUserNotification/activationType-swift.property)

Specifies what caused a user notification to occur.

[`additionalActivationAction`](/documentation/Foundation/NSUserNotification/additionalActivationAction)

An additional action selected by the user.

[`additionalActions`](/documentation/Foundation/NSUserNotification/additionalActions)

The actions that can be taken on a notification in addition to the default action.

### User Notification User Information

[`userInfo`](/documentation/Foundation/NSUserNotification/userInfo)

Application-specific user info that can be attached to the notification.

### Constants

[`NSUserNotification.ActivationType`](/documentation/Foundation/NSUserNotification/ActivationType-swift.enum)

These constants describe how the user notification was activated.

[`NSUserNotificationDefaultSoundName`](/documentation/Foundation/NSUserNotificationDefaultSoundName)

The default notification sound.


---

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)