Push Notifications

Implement, review, and debug local and remote notifications on iOS/macOS using UserNotifications and APNs. Covers permission flow, token registration, payload structure, foreground handling, notification actions, grouping, and rich notifications. Targets iOS 26+ with Swift 6.3, backward-compatible to iOS 16 unless noted.

Keep adjacent domains separate: Live Activity content-state payloads belong in activitykit; PushKit/VoIP call pushes belong in callkit; App Clip ephemeral notification setup belongs in app-clips; long-running or scheduled background work after a silent push belongs in background-processing.

Correction Reviews
Permission Flow
APNs Registration
Local Notifications
Remote Notification Payload
Notification Handling
Notification Actions and Categories
Notification Grouping
Common Mistakes
Review Checklist
References

push-notifications

Push Notifications

Contents