Notifications Delayed

Possible reasons notifications can be delayed or not shown quickly.

Normally push notifications arrive quite quickly. The most common reason for notifications being delayed is the device had unstable or no internet connection and the notification did not arrive until the connection was made (defaults to 3 days).

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 and/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 Power Management Restrictions:

Setting High Notification Priority can assist with older Android device 7-. Android 8+ now use Android Notification Categories.

  1. The app may have been force-closed. A normal close such as swiping your app away is a normal close and won't be an issue on most devices. However, force-closing it through the app settings, task killer, or through Android Studio would result in most Intents (including pushes) preventing services from starting.

    • Also some Xiaomi and Huawei devices will put your app in a force-closed state after swiping it away or after some time. See the following documentation for more details on this and the logcat message to confirm this.
  2. 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.

  3. Doze Mode can delay notifications even when sending with the highest priority. This depends on Android's App Standby Buckets and are subject to change.

App Standby Buckets

Devices running Android P and newer implement app standby buckets which may lead to notifications being delayed.

The following values may change. See the Android docs for most updated values

Setting"Jobs" = Normal"Alarms" = High
Active:No RestrictionNo Restriction
Working Set:Deferred up to 2 hoursDeferred up to 6 minutes
Frequent:Deferred up to 8 hoursDeferred up to 30 minutes
Rare:Deferred up to 24 hoursDeferred up to 2 hours

Delays for notifications on iOS devices:

  1. Mentioned above, 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. 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. Mentioned above, 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.