# Troubleshooting

Common issues and solutions for Airship plugin setup, initialization, and integration.

<!-- PAGE: Troubleshooting Initialization, PATH: https://www.airship.com/docs/developer/sdk-integration/capacitor/troubleshooting/initialization/ -->

# Troubleshooting Initialization

> Troubleshoot common initialization issues and apply solutions.
When following steps in [Getting Started](https://www.airship.com/docs/developer/sdk-integration/capacitor/installation/getting-started/) or [Advanced Configuration](https://www.airship.com/docs/developer/sdk-integration/capacitor/installation/advanced-configuration/), if you don't see a channel ID in the logs or encounter errors during initialization, review the following common problems and solutions.

## Installation errors

If you encounter errors during installation:

- Verify that you're using a compatible version of Capacitor. See [Requirements](https://www.airship.com/docs/developer/sdk-integration/capacitor/installation/getting-started/#requirements) in *Getting Started*.
- Ensure all native dependencies are properly synced with `npx cap sync`.
- Check that your iOS and Android projects are correctly configured.

## Initialization errors

If you encounter errors during SDK initialization:

- Verify your credentials in the Airship dashboard. The credentials used by `takeOff` are your Airship project's [App Key](https://www.airship.com/docs/reference/glossary/#app_key) and [App Secret](https://www.airship.com/docs/reference/glossary/#app_secret). To find them, select the dropdown menu (▼) next to your project name, and then **Project details**.
- Check that `takeOff` is called correctly in your app or configured in `capacitor.config.json`.
- Ensure both iOS and Android native modules are properly installed.


<!-- /PAGE: Troubleshooting Initialization -->

<!-- PAGE: Troubleshooting Push Notifications, PATH: https://www.airship.com/docs/developer/sdk-integration/capacitor/troubleshooting/push-notifications/ -->

# Troubleshooting Push Notifications

> Check push notification status and fix common issues.
If [push notifications](https://www.airship.com/docs/developer/sdk-integration/capacitor/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:

```typescript
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:

```typescript
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')
  }
})
```



<!-- /PAGE: Troubleshooting Push Notifications -->