AndroidImportance

Android Only

The interface describing the importance levels of an incoming notification.


The importance level can be set directly onto a notification channel for supported devices (API Level >= 26) or directly onto the notification for devices which do not support channels.

The importance is used to both change the visual prompt of a received notification and also how it visually appears on the device.

View the Android Appearance documentation to learn more.

Members

DEFAULT

The default importance applied to a channel/notification.

The application small icon will show in the device statusbar. When the user pulls down the notification shade, the notification will show in it's expanded state (if applicable).

HIGH

The highest importance level applied to a channel/notification.

The notifications will appear on-top of applications, allowing direct interaction without pulling down the notification shade. This level should only be used for urgent notifications, such as incoming phone calls, messages etc, which require immediate attention.

LOW

A low importance level applied to a channel/notification.

On Android, the application small icon will show in the device statusbar, however the notification will not alert the user (no sound or vibration). The notification will show in it's expanded state when the notification shade is pulled down.

On iOS, the notification will not display to the user or alert them. It will still be visible on the devices notification center.

MIN

The minimum importance level applied to a channel/notification.

The application small icon will not show up in the statusbar, or alert the user. The notification will be in a collapsed state in the notification shade and placed at the bottom of the list.

This level should be used when the notification requires no immediate attention. An example of this importance level is the Google app providing weather updates and only being visible when the user pulls the notification shade down,

NONE

The notification will not be shown. This has the same effect as the user disabling notifications in the application settings.


Copyright 2020 - 2021 © Invertase Limited

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License and code samples are licensed under the Apache 2.0 License.

All product names, logos, and brands are property of their respective owners. All company, product and service names used in this website are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.