<!--
{
  "availability" : [
    "iOS: 8.0 -",
    "iPadOS: 8.0 -",
    "macCatalyst: 13.0 -",
    "macOS: 10.15 -",
    "visionOS: 1.0 -",
    "watchOS: 6.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "PushKit",
  "identifier" : "/documentation/PushKit",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "PushKit"
    ],
    "preciseIdentifier" : "PushKit"
  },
  "title" : "PushKit"
}
-->

# PushKit

Respond to push notifications related to your app’s complications, file providers, and VoIP services.

## Overview

The PushKit framework supports specialized notifications for updating your watchOS complications, responding to file provider changes, and receiving incoming Voice-over-IP (VoIP) calls. PushKit notifications differ from the ones you handle with the <doc://com.apple.documentation/documentation/UserNotifications> framework. Instead of displaying an alert, badging your app’s icon, or playing a sound, PushKit notifications wake up or launch your app and give it time to respond. Both PushKit and User Notifications use the Apple Push Notification service (APNs) to deliver push notifications to user devices.

To receive PushKit notifications, your app creates a [`PKPushRegistry`](/documentation/PushKit/PKPushRegistry) object and uses it to configure the notification types it supports. When registration is successful, PushKit delivers a unique data token to your app that contains the identity of the current device and the push type. Forward that token along to the server, and include it in any notifications you send to the user. APNs uses the token to deliver the correct type of notification to the user’s device.

For information about how to configure your server to work with APNs, see <doc://com.apple.documentation/documentation/UserNotifications/setting-up-a-remote-notification-server>.

> Note: PushKit doesn’t support some special use cases in which access to Apple Push Notification service (APNs) isn’t possible. For information about when you might need to support these cases, see [iOS 10 and the Legacy VoIP Architecture](https://developer.apple.com/library/archive/qa/qa1938/_index.html#//apple_ref/doc/uid/DTS40017564).

## Topics

### Registration

[Supporting PushKit Notifications in Your App](/documentation/PushKit/supporting-pushkit-notifications-in-your-app)

Declare the types of PushKit notifications your app supports and configure objects to respond to them.

[`PKPushRegistry`](/documentation/PushKit/PKPushRegistry)

An object that requests the delivery and handles the receipt of PushKit notifications.

[`PKPushRegistryDelegate`](/documentation/PushKit/PKPushRegistryDelegate)

The methods that you use to handle incoming PushKit notifications and registration events.

[`PKPushCredentials`](/documentation/PushKit/PKPushCredentials)

An object that encapsulates the device token you use to deliver push notifications to your app.

### Push Types

[Responding to VoIP Notifications from PushKit](/documentation/PushKit/responding-to-voip-notifications-from-pushkit)

Receive incoming Voice-over-IP (VoIP) push notifications and use them to display the system call interface to the user.

[`PKPushType`](/documentation/PushKit/PKPushType)

Constants reflecting the push types you want to support.

### Payload

[`PKPushPayload`](/documentation/PushKit/PKPushPayload)

An object that contains information about a received PushKit notification.

### Data export

[Exporting delivery metrics logs](/documentation/PushKit/exporting-delivery-metrics-logs)

Download and analyze push-notification metrics.

[Exporting broadcast push notification metrics](/documentation/PushKit/exporting-broadcast-push-notification-metrics)

Discover how many people subscribe to your broadcast channels, and how many messages they receive.


---

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)