Confirmed delivery

​

Overview

Confirmed Deliveries Flow

• iOS & Safari: Apple Push Notification Service (APNs)
• Android & Chrome: Google Firebase Cloud Messaging (FCM)
• Huawei devices: Huawei Messaging Service (HMS)
• Amazon devices: Amazon Device Messaging (ADM)
• Windows devices: Microsoft Push Notification Service (MPNS)

• The notification ID
• The device’s Subscription ID

​

Requirements

• Available only on paid plans. Compare plans.
• Complete Mobile SDK Setup, including:
  • iOS Notification Service Extension
  • App Group configuration
• Confirmed Delivery only works if the device has the OneSignal SDK installed.
  • Not supported for subscriptions created via API only.

​

Platform-specific limitations

​

iOS

• Requires both the Notification Service Extension and App Group setup.
• APNs keeps only one message per app when offline. If multiple pushes are sent while offline, only the latest is delivered.

​

Huawei

• Supported only for the data Huawei message type.
• For the message type, Huawei provides receipt data only in their own dashboard.

​

Web

• Safari does not support Confirmed Delivery.

​

FAQ

​

Why are my Confirmed Delivery numbers low or missing?

1. Many inactive or abandoned devices. See Handling inactive devices.
2. Platform limitations (Huawei, Safari).
3. Setup issues — especially common with iOS. See Troubleshooting Confirmed Delivery.
4. Android devices may force quit your app, stopping SDK events. Some device manufacturers treat swiping the app away as a force quit. See Mobile push not shown guide.

​

Handling inactive devices

• Use Audience Activity to resend to users who did not Confirm Delivery.
• Create Segments based on Last Session (e.g., inactive for 90+ days).
  • Combine with a Re-engagement Journey to win them back.
  • Periodically target inactive users to prune unreachable devices.

​

Why does it show Confirmed but not appear on my device?

• You may have missed it. Try sending yourself a test push to see if it appears.
• Focus Mode on iOS: Pushes are delayed or grouped differently when “Do Not Disturb,” “Sleep,” or other Focus modes are active. Dismissing grouped notifications may cause you to miss it.
• Custom app code suppressing display:
  • event.preventDefault() in the foreground lifecycle listener or Notification Service Extension
  • Notification APIs that remove messages:
    • removeDeliveredNotifications(withIdentifiers:)
    • removeAllDeliveredNotifications()
• Push payload settings:
  • Make sure priority is set to high. See Push priority.
  • Be careful with collapse_id — it replaces older pushes with newer ones using the same ID.
• Wrong device targeted: Use Find and set Test Subscriptions to confirm.

​

Troubleshooting Confirmed Delivery

​

General

• Device offline: Pushes can be delayed up to 3 days (default). Adjust with Time To Live.
• Unstable network: Notification may be received but the confirmation fails if the app crashes or has no network. This is rare.

​

iOS

1. Add the OneSignalNotificationServiceExtension target in Xcode.
2. Double-check steps 3–6 in the iOS SDK Setup. Make sure to use the same App Group name for both app and extension:
   • ✅ group.your-main-app-target-bundle-id.onesignal
   • ❌ group.your-bundle-id.OneSignalNotificationServiceExtension.onesignal
   • If you use your own App Group name, you need to update your Info.plist files for both the main app and the Notification Service Extension to tell our SDK which App Group to use.
3. Ensure mutable-content: 1 is present in the payload (set automatically unless overridden).

​

Android

• If notifications are not displaying: see Mobile push troubleshooting.
• If notifications show but Confirmed Delivery is missing: a custom Android Service Extension may be blocking it. Check our Android Service Extension guide.

​

Web

• Safari is not supported.
• For other browsers, ensure migration to v16 SDK is complete:
  • Correct SDK init:
    Copy

    Ask AI

    <script src="https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.page.js" defer></script>
    

  • Correct Service Worker reference:
    Copy

    Ask AI

    importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");