Troubleshooting Push Notifications

Check push notification status and fix common issues.

If push notifications aren’t working as expected, you can check the notification status to diagnose the issue.

Push Notifications Not Working

If push notifications are not being received:

  • Verify that push notifications are enabled for both iOS and Android.
  • Check that APNs (iOS) and FCM (Android) are properly configured.
  • Ensure the app has notification permissions.

Checking Push Notification Status

If you’re having trouble with push notifications, check the notification status to see the current state:

const status = await Airship.push.getNotificationStatus()

console.log('Are notifications allowed:', status.areNotificationsAllowed)
console.log('Is opted in:', status.isOptedIn)
console.log('Is user notifications enabled:', status.isUserNotificationsEnabled)
console.log('Is airship opted in:', status.isAirshipOptedIn)
console.log('Is user opted in:', status.isUserOptedIn)
console.log('Is pushable:', status.isPushable)
console.log('Is privacy manager enabled:', status.isPrivacyManagerEnabled)

You can also listen for status changes to debug permission issues:

const handle = await Airship.push.onNotificationStatusChanged(event => {
  console.log('Notification status changed:', event.status)
  
  if (!event.status.areNotificationsAllowed) {
    console.log('System-level notifications are disabled')
  }
  
  if (!event.status.isUserNotificationsEnabled) {
    console.log('User notifications are disabled in Airship')
  }
  
  if (!event.status.isPushable) {
    console.log('Device is not pushable')
  }
})