OneSignal Help & Documentation

Welcome to the OneSignal New IA developer hub. You'll find comprehensive guides and documentation to help you start working with OneSignal New IA as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Discussions

Notifications Delayed

Possible reasons notifications can be delayed or not shown quickly.

Normally push notifications do arrive quite quickly. The most common reason for notifications being delayed is the device had no internet connection or a poor connection and the notification did not arrive until the connection was made.

When notifications get sent from OneSignal, they go to Google (FCM), Apple (APNS), Windows (WNS), and other messaging servers. OneSignal is in charge of sending these requests to these Push Servers which then deliver it to your subscribers.

When looking at a notification in your Message Reports you can see how fast OneSignal sent the push when viewing the notification directly.

In the above case, we sent the push to the Google or Apple servers in 0.33 seconds.

If the device receiving the push does not get it right away, it could be an issue with the FCM, APNS servers (rare) or the device had unstable internet causing a delay (common).

Other issues can be as follows:

Delays for notifications on Android Devices:

  1. Some home and commercial wifi routers will cause the device's connection to Google's FCM servers to be closed. The device later re-opens the connection and receives the delayed notifications. (Discussed here: https://groups.google.com/forum/#!topic/android-gcm/Y33c9ib54jY)

  2. Some custom versions of the Android OS have a "power-saving" setting that can cause notifications to be delayed or ignored. For instance, Sony Xperia devices have a "Stamina Mode" and other device's have similar modes discussed in our Notification Not Shown Guide

  3. Some Android devices can enter a low power mode when their battery is low that may cause slight delays in receiving notifications. This is more common on Android 9 devices with the New Power Management Restrictions:

  4. Notification Priority can delay notifications depending on the device's battery level and settings.

  5. Remote images and icons, adding an image to your notification could cause the notification to be delayed as it has to wait to download the full image(s) first. Try omitting your image(s) temporarily to rule this factor out.

Delays for notifications on iOS devices:

  1. As with Android, some wifi routers will cause iOS notification delivery delays.

  2. Notifications may be delayed if "Restrict background data" is checked for the app, if Wifi-Optimization is turned on in the advanced settings, or if priority mode is enabled.

  3. "Low Power Mode" is enabled. If in your Settings > Battery > Low Power Mode is enabled, this will reduce the rate at which notifications can be received or turn them off completely.

  4. Data only notifications, without a message body, are sent at a normal priority instead of high due to Apple's limitations. These can be delayed by a few minutes.

  5. Development builds of your app with connect to Apple's Sandbox APN server which may be slower. We recommend testing with release mode such as with an ad-hoc or test flight build so your app will use Apple Production APN server to rule out any delays their Sandbox server could cause.

  6. Notification media attachments, adding an image to your notification could delay it up to 30 seconds as it downloads it. Try omitting your image temporarily to rule this factor out.

WhatsApp has a good list of instructions on troubleshooting delayed Android and iOS notification at the bottom of their FAQ page here: https://www.whatsapp.com/faq/en/android/20887936

Delays for notifications on Web:

  1. As with Android, some home and commercial wifi routers will cause the device's connection to Google's FCM/GCM servers to be closed. The device later re-opens the connection and receives the delayed notifications. (Discussed here: https://groups.google.com/forum/#!topic/android-gcm/Y33c9ib54jY)

  2. Depending on the browser being used, there are a few factors that determine if a notification can be received when the browser is not running.

Updated 7 days ago


Notifications Delayed


Possible reasons notifications can be delayed or not shown quickly.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.