The editable content for a notification.


@interface UNMutableNotificationContent : UNNotificationContent


Create a UNMutableNotificationContent object when you want to specify the payload for a local notification. Specifically, use this object to specify the title and message for an alert, the sound to play, or the value to assign to your app's badge. You might also provide details about how the system handles the notification. For example, you can specify a custom launch image and a thread identifier for visually grouping related notifications.

After creating your content object, assign it to a UNNotificationRequest object, add a trigger condition, and schedule your notification. The trigger condition defines when the notification is delivered to the user. Listing 1 shows the scheduling of a local notification that displays an alert and plays a sound after a delay of five seconds. The strings for the alert's title and body are stored in the app’s Localizable.strings file.

Listing 1

Creating the content for a local notification

// Configure the notification's payload.
UNMutableNotificationContent* content = [[UNMutableNotificationContent alloc] init];
content.title = [NSString localizedUserNotificationStringForKey:@"Hello!" arguments:nil];
content.body = [NSString localizedUserNotificationStringForKey:@"Hello_message_body"
content.sound = [UNNotificationSound defaultSound];
// Deliver the notification in five seconds.
UNTimeIntervalNotificationTrigger* trigger = [UNTimeIntervalNotificationTrigger
            triggerWithTimeInterval:5 repeats:NO];
UNNotificationRequest* request = [UNNotificationRequest requestWithIdentifier:@"FiveSecond"
            content:content trigger:trigger];
// Schedule the notification.
UNUserNotificationCenter* center = [UNUserNotificationCenter currentNotificationCenter];
[center addNotificationRequest:request];

Localizing the Alert Strings

The strings you display in a notification alert should be localized for the current user. Although you can use the NSLocalizedString macros to load strings from your app’s resource files, a better option is to specify your string using the localizedUserNotificationStringForKey:arguments: method of NSString. The localizedUserNotificationStringForKey:arguments: method delays the loading of the localized string until the notification is delivered. Thus, if the user changes language settings before a notification is delivered, the alert text is updated to the user’s current language instead of the language that was set when the notification was scheduled.


Getting the Notification Data


The localized title, containing the reason for the alert.


The localized subtitle, containing a secondary description of the reason for the alert.


The localized message to display in the notification alert.


The number to apply to the app’s icon.


The sound to play when the notification is delivered.


The name of the custom launch image to display when your app is launched in response to the notification.


A dictionary of custom information associated with the notification.


An array of attachments to display in an alert-based notification.

Setting the Notification Summary


The string the notification adds to the category’s summary format string.


The number of items the notification adds to the category’s summary format string.

Identifying the Content


The identifier of the category object that represents the notification's type.


An identifier that you use to group related notifications together.


A value your app uses to identify the notification content.


See Also

Notification Content


The uneditable content of a notification.


A media file associated with a notification.


The sound played upon delivery of a notification.


A string providing the name of a sound file.