📘

Looking for website help?

If you only have a website and no mobile apps, see our Web Push Troubleshooting guide.

Troubleshooting steps

1. Update the OneSignal SDK

OneSignal regularly makes updates. If you are using our Mobile SDKs and have not updated your app in awhile, chances are your issue was fixed in a more recent SDK version.

You can find the most recent versions on Github > your SDK > Releases.

2. Check the error logs

To fix an error its best to find it first. Follow our guide on getting a debug log to check for any errors that can help identify any existing issues.

3. Test the example project for your SDK

Check to see if your issue is reproducible using the build created by our engineering team for each SDK .

• iOS example project
• Android example project
• Cordova variants example project
• React Native example project
• Flutter example project
• Unity example project
• .NET Maui example project

4. See our troubleshooting guides

Here is a quick reference table of our SDK's Troubleshooting Docs:

• Troubleshooting Web
• Troubleshooting Android
• Troubleshooting iOS
• Troubleshooting Flutter
• Troubleshooting React-Native
• Troubleshooting Unity
• Troubleshooting Cordova variants
• Troubleshooting .NET Maui

Notification troubleshooting

• Notifications not shown - mobile push
• Notification images not showing
• Notification CTR
• Duplicated notifications
• Notifications delayed

In-App message troubleshooting

• In-App Message troubleshooting

Live activities troubleshooting

• Live activities troubleshooting

FAQ

What happens if I change my OneSignal App ID in my app?

Changing the OneSignal App ID in your app's initialization code will create a brand new user and push subscription under the new App ID when the user updates and opens the app to the latest version.

If your iOS bundle ID and/or Android package ID are the same, then the device will continue with the same push subscription status. The user data will be brand new i.e. you will need to add back your aliases, tags, email address, phone number on the new record.

If the iOS bundle ID or Android package ID are different, then this this a brand new app and should have different push certs/keys.

Which mobile devices support mobile app push?

OneSignal supports mobile app push notifications on iOS 11+ and Android 5+. This covers over 99% of active devices.

Why are my push notifications not showing?

See the Notifications Not Shown guide.

Why are push notification images not showing?

See Notification Images Not Showing guide.

Can OneSignal send push notifications in an on-premise closed network?

This can work as long as the computers on your closed network have access to the push gateway servers that you want to support:

• https://support.apple.com/en-us/HT203609
• https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall

If the network is completely disconnected from the Internet, push notifications cannot be delivered via the standard OS/browser services, which is what we support.