When a notification shows as "Delivered" on our system, it means we have successfully sent the notification to Google or Apple's servers which distribute the notifications to subscribers.

The following are reasons why notifications may show as "Delivered" on the OneSignal dashboard or API, but are not visible on your device or website.

Network issues

The network / WiFi you're connected to may have closed your connection to Apple or Google servers'. Try disabling and re-enabling your internet connection. See our Notifications delayed troubleshooting guide for more details details.

Not Subscribed

Please see our Player ID guide for info on finding your device in the OneSignal dashboard to make sure it is still subscribed.

---

Mobile Specific

If your device is subscribed and has a working network connection, try adding your device as a Test User. Make sure you are using the latest version of the OneSignal SDK and have the app running in the background when you test the push.

Then follow these points if you still do not get the notification:

The app has push permissions Disabled

Each OneSignal SDK has a setSubscription method. If this is set to false then the device will show as subscribed in the app settings, but is actually unsubscribed from OneSignal in All Users. Make sure you did not add this property to your app.

Also, make sure push permissions are enabled for the device:

• iOS - Check your app under Settings > Notifications.
• Android - Check the notification setting under Settings > Apps

The app is currently In Focus

Please check the value you added in you init for inFocusDisplaying or inFocusDisplayType depending on your Mobile SDK Version.

If you set this to None or 0 then no notification will show while the app is open. There are other options you can set this to if you want to show notifications while the app is open.

The app is Force Stopped

When an app is in a "Force Stopped" state most events including GCM/FCM messages for push notifications will not be received. An app can be placed in this state in the following ways.

• From Settings > Apps, "Force Stop" is pressed.
• Long pressing the back button on some devices.
• Using a 3rd party task killer like Greenify.
• Swiping away your app while remote debugging it.
  • Not the same as viewing the logcat but launching your app as a remote debug process.
• Swiping away your app from the recent apps on list on a Xiaomi device.
• Automatically on some devices due to custom Android tweaks done by manufactures. Steps below on disabling this.

More information on problematic devices can be found in our blog post: Notifications are highly reliable, except when device manufacturers interfere

Checking your app state

1. Run the following to check the current state of your app.
Replace "com.company.appname" with your package name.

adb shell dumpsys package com.company.appname | grep stopped

If you see stopped=false if everything is fine, otherwise you will see stopped=true then your app was force killed in some way.

2. Another way is to send a few notifications and check for the following GCM logcat entry.

W/GCM-DMM: broadcast intent callback: result=CANCELLED forIntent {
   act=com.google.android.c2dm.intent.RECEIVE pkg=com.onesignal.example (has extras)
}

If you seen this cancelled intent above then your app could not be started to process the notification.

Some device manufactures will white list apps from going into the force closed state. Example such as Gmail and Whatsapp.

Low Power or Energy Saving Mode

Some devices have a specific battery optimization that will stop notifications from showing.

• iOS -"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.

Action buttons or iOS 10+ media are set and requirements are not meet

The app must be not force killed and the correct settings must be enabled when these options are set.
See our Notifications with action buttons or iOS 10+ media not displaying section for a full check list.

Additional Debugging

FCM provides a REST API to query the last time a device has been connected to FCM. See the following Google documentation on how to get this.
https://developers.google.com/instance-id/reference/server#get_information_about_app_instances

---

Web Specific

Full Screen

Full screen mode in some older browser versions prevent web push notifications from appearing. Make sure no windows are in full screen mode. Please see Web Push Troubleshooting Docs for more.

Notifications are blocked in Settings

Check your browser settings on desktop or app settings on mobile:

• Windows users see: https://www.digitaltrends.com/computing/how-to-configure-notifications-action-center-windows-10/2/

• MacOS users, make sure you do not have "DO NOT DISTURB" mode on in your System Preferences. https://www.imore.com/how-use-do-not-disturb-mac

• Android mobile, please check in your Settings > Application Manager > Chrome. Make sure Show notifications is checked like this: https://i.imgur.com/LY810Mj.png on Firefox it will be the same: https://i.imgur.com/a3lB88b.png

Clearing Browser Data

Clearing your browser cookies, data, and/or history will cause the browser to not get notifications any longer and will need to revisit the site to re-subscribe.

Browser App Data Full

If your mobile browser app has reached its data limit or its data is full, you will need to clear the data on the app.

Unsupported Browser

Users must subscribe to notifications on their desktop or mobile device to receive notifications and it must be a browser that supports push notifications. Please see Supported Web Platforms.

Debugging Web Push Notifications

Please follow these simple steps to debug your site:

1. Use Chrome (or your favorite browser for debugging if a developer) and go to your site url with the OneSignal code. Open the JavaScript console. Generally, this is done by:

• right click the site and press "Inspect", or
• in the Chrome Menu select View > Developer > JavaScript Console

2. In the console use this code to send yourself a push notification if you are still subscribed:
OneSignal.sendSelfNotification();

3. If no notification shows up, follow Clearing your cache and resetting push permissions to access your site as a first time user and resubscribe.

4. Then in the Console use this code to get your new OneSignal Player ID:
OneSignal.getUserId(function(id){console.log(id)});

5. You can copy-paste that player id into your onesignal.com All Users page and add yourself as a Test User this will also tell you if you are subscribed correctly.

6. Repeat step 2 to send yourself a notification with OneSignal.sendSelfNotification();

If you still do not get the notification, contact support and provide your new player id and site URL with the OneSignal code.