Unity Setup

How to install the Airship Unity plugin.


  • Unity 5+
  • iOS: Xcode 14.3+
  • iOS: Minimum deployment target iOS 14+
  • Android: Android SDK installed and updated (requires minSdkVersion = 21+)
  • Android: Using Android SDK manager, install API 33+.
    • If a Custom Gradle Template is used, the gradle template needs to be configured to use API VERSION 33+.


Download the latest plugin and import the unitypackage into the Unity project: Open Assets -> Import Package -> Custom Package.

Configure Airship Settings: Open Window -> Airship -> Settings and set the Airship settings.


Leave the Android FCM Sender ID field BLANK for both Production and Development.


If your app uses Airship’s EU cloud site, you will need to configure that using the Cloud Site setting.

After generating a project for iOS, enable Push Notifications in the project editor’s Capabilities pane:

After adding the Push Notifications capability, download the Android Firebase configuration file, google-services.json, from the application’s Firebase console and add it to the Assets directory.

If your Unity application does not have an associated application in the Firebase console, follow the FCM setup instructions to set one up.

If proguard is enabled, add Airship settings to the proguard-user.txt file:

-keep public class com.urbanairship.unityplugin.UnityPlugin -keepclassmembers class com.urbanairship.unityplugin.UnityPlugin { public ; public ; static ; }

Notification Service Extension

To take advantage of notification attachments, such as images, animated gifs, and video, you will need to create a notification service extension.

Follow the steps in the iOS Notification Service Extension Guide.