Notifications

Schedule local notifications and receive push notifications delivered through APNs.

Read the documentation Visit website WWDC sessions

Introduced

2009

iPhone OS 3.0

Kind

Framework

Runs on

Get it from

iOS

10.0+

iPadOS

10.0+

Mac Catalyst

13.1+

macOS

10.14+

tvOS

10.0+

visionOS

1.0+

watchOS

3.0+

Overview

The User Notifications framework lets apps show alerts, play sounds and badge the app icon, whether or not the app is running. Apps can schedule local notifications with time, calendar or location triggers, or receive remote notifications that a server sends through Apple Push Notification service (APNs).

It also handles permission requests, including provisional authorization, actionable notification categories and service extensions that modify incoming content. Broadcast push updates Live Activities at scale, and the Push Notifications Console sends test notifications and shows delivery logs.

Local notifications

Schedule alerts from the app using time, calendar or location triggers.

Remote notifications

Your server sends push notifications that APNs delivers to devices.

Broadcast push

Update every subscribed Live Activity with a single push to a channel.

Push console

Send test pushes, view delivery logs and validate tokens in a browser.

ReminderScheduler.swift

import UserNotifications

let center = UNUserNotificationCenter.current()
try await center.requestAuthorization(options: [.alert, .sound, .badge])

let content = UNMutableNotificationContent()
content.title = "Time to stretch"
content.body = "You've been sitting for an hour."

let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 60 * 60, repeats: false)
let request = UNNotificationRequest(identifier: "stretch-reminder", content: content, trigger: trigger)
try await center.add(request)

History