This guide helps you troubleshoot issues related to receiving duplicate push notifications. If you’re seeing duplicate in-app messages, refer to our Duplicated In-App Messages guide.

• Apple acknowledged a bug in iOS 17 that caused duplicates. This was fixed in iOS 17.3. Read more.
• If you’re using OneSignal Android SDK versions 4.4.1 – 4.6.2, update to the latest version to avoid known issues.

Same message sent multiple times

The most common cause of duplicate notifications is sending the same notification payload more than once through the OneSignal API.

Common reasons:

  • Your server retries requests without checking if the first succeeded.
  • Accidental logic duplication in your backend notification pipeline.
  • You’re migrating to OneSignal but still sending notifications from a previous provider. Avoid sending from both systems simultaneously.

Multiple push notification SDKs

Check if your app includes another push notification SDK (e.g., Firebase, Urban Airship). These may also process and display OneSignal notifications.

  • OneSignal includes logic to avoid duplication when it is the only SDK.
  • Other SDKs may not recognize and filter out OneSignal’s payloads, leading to multiple displays.

See FAQ below for more on SDK interoperability.

Multiple app instances

Android

Duplicate notifications may occur when:

  • You have both production and development versions of your app installed.
  • Each app has a unique package name and receives its own push token.

Long press on a notification to confirm which app instance it came from.

Diagnostic tips

To help us debug duplicate issues faster, collect and send:

  • OneSignal SDK version
  • Device OS version
  • Build environment (Mac/Windows)
  • Xcode logs or logcat outputs
  • List of other libraries/plugins in your app
  • Detailed reproduction steps

FAQ