Feature overview
Notification icons are the core visual identity of a mobile app in the system notification bar and status bar. They help users quickly identify the message source and app brand. Small icons usually appear in the top status bar and at the upper-left of a notification. This document describes manufacturer channel support for custom small icons and how to implement the feature.
Manufacturer channel support
Due to restrictions on different phone operating systems, only some manufacturer channels support custom small icons. Support is as follows:
Device type | Custom small icon supported |
iOS | Follows the app home-screen icon. |
FCM | Supported. |
Integration
Supported manufacturers
Google FCM supports customization.
Configuration
Configure it in the manifest of the app main module:
<!-- [START fcm_default_icon] -->
<!-- Set custom default icon. This is used when no icon is set for incoming notification messages.
See README(https://goo.gl/l4GJaQ) for more. -->
<meta-data
android:name="com.google.firebase.messaging.default_notification_icon"
android:resource="@drawable/your_icon_resource_name" />
<!-- Set color used with incoming notification messages. This is used when no color is set for the incoming
notification message. See README(https://goo.gl/6BKBk7) for more. -->
<meta-data
android:name="com.google.firebase.messaging.default_notification_color"
android:resource="@android:color/white" />
<!-- [END fcm_default_icon] -->
Note:
FCM icon requirements:
The small icon must be a PNG with an alpha transparency channel.
The background must be transparent.
Avoid too much padding around the icon.
Use 46 x 46px consistently. Icons that are too small look blurry; icons that are too large are scaled down by the system.
Customization is not supported. The app icon is used by default.