Documentation Archive


Local and Remote Notification Programming Guide

Document Revision History

This table describes the changes to Local and Remote Notification Programming Guide.




Moved to Retired Documents Library.


Noted that you can create a background update notification that also alerts the user; mentioned larger token size.


Updated figures in APNs Overview chapter to clarify device token use.

Updated figures Figure 6-7 and Figure 6-5.

In APNs Overview, clarified the differences between token-based and certificate-based provider-to-APNs trust.

Implemented clarifications throughout APNs Overview and Configuring Remote Notification Support.


Restructured the book to provide a more clear separation between app-specific and server-side functionality.

Updated the book to reflect the use of the User Notifications framework.


Added guidance, primarily in the APNs Overview chapter, on using a provider authentication token for APNs.

Corrected Figure 6-5.

Updated Figure 6-3 to illustrate using a provider authentication token.

Added a note in the APNs Overview chapter that in iOS 10 and later you should implement local notifications with the User Notifications framework and the User Notifications UI framework.

Added a note about the requirement for a GeoTrust Global CA root certificate for providers, in Provider-to-APNs Connection Trust.

Updated and expanded HTTP/2 Response from APNs.

Clarified Quality of Service, Store-and-Forward, and Coalesced Notifications.


Minor clarifications and corrections throughout document.

Removed information about the content-length property from the Communicating with APNs chapter. This property is not relevant to the APNs provider API because of two factors. 1. An APNs payload always fits inside a single DATA frame. 2. The length of a DATA frame is declared in the frame header, according to the HTTP/2 specification. Eliminating the content-length property reduces bandwidth, complexity, and processing time for APNs requests.


Updated to describe the HTTP/2-based APNs provider API, available starting December 2015.


Updated information about the provisioning and development workflow.


Clarified where custom notification sounds can be stored and made minor corrections.


Added information about users changing their notification settings in the Settings app.


Made minor corrections.


Added information about custom notification actions and location-based notifications. Removed note stating that not all notification types are available in OS X—all types are delivered.

Changed title from Local and Push Notification Programming Guide.


Added note about content-available key. Added information about notification custom actions and location-based notifications.

Changed title from Local and Push Notification Programming Guide.


Added note about content-available key.


Added information about setting priority for a push notification.


Updated chapter "Provider Communication with Apple Push Notification Service". Minor changes throughout other chapters.

Added section Provider Authentication Tokens. Added error code 10 to Note. Expanded discussion in APNs Provider Certificates. Moved discussion of a legacy protocol to an appendix.


Added information about implementing push notifications on an OS X desktop client. Unified the guide for iOS and OS X.


Describes how to determine if an application is launched because the user tapped the notification alert's action button.


Changed occurrences of "iPhone OS" to "iOS."


Updated and reorganized to describe local notifications, a feature introduced in iOS 4.0. Also describes a new format for push notifications sent to APNs.


Made many small corrections.


Made minor corrections and linked to short inline articles on Cocoa concepts.


Added notes about Wi-Fi and frequency of registration, and gateway address for the development environment. Updated with various clarifications and enhancements.


First version of a document that explains how providers can send push notifications to client applications using Apple Push Notification Service.