How do I set a custom notification icon for Android push notifications in Unity?

To display a custom icon for push notifications on Android, add the icon to an Android library folder in your Unity project and declare it in the AndroidManifest.xml.

Note: For modern Android versions, the status bar icon must be monochrome (white with a transparent background).

Follow these steps:

1. Prepare your icon: Create your notification icon as a small, white icon on a transparent background (e.g. notification_icon.png).

2. Place the icon in an Android library folder: Unity only compiles Android resources that live inside a *.androidlib folder under Assets/Plugins/Android/. The Pushwoosh Unity SDK no longer ships such a folder (since the SDK moved to UPM packages, its Android side is a single .aar), so create your own, for example:

   Assets/Plugins/Android/my-resources.androidlib/
       AndroidManifest.xml
       project.properties
       res/drawable/notification_icon.png
   

   The AndroidManifest.xml inside the folder can be minimal (a <manifest> element with your package name), and project.properties should contain android.library=true. Without these two files Unity will not treat the folder as an Android library and the drawable will not be packaged.

3. Update your main AndroidManifest.xml at Assets/Plugins/Android/AndroidManifest.xml. Add the following <meta-data> tag inside the <application> tag:

   <application ...>
       <meta-data
           android:name="com.pushwoosh.notification_icon"
           android:resource="@drawable/notification_icon" />
   </application>
   

   You can also set the accent colour with com.pushwoosh.notification_icon_color.

4. Important: Replace notification_icon with the name of your icon file, without the .png extension. After rebuilding your app, new notifications will display your custom icon.