Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Nested Classes](https://developer.android.com/reference/android/app/Notification#nestedclasses) \| [Constants](https://developer.android.com/reference/android/app/Notification#constants) \| [Inherited Constants](https://developer.android.com/reference/android/app/Notification#inhconstants) \| [Fields](https://developer.android.com/reference/android/app/Notification#lfields) \| [Ctors](https://developer.android.com/reference/android/app/Notification#pubctors) \| [Methods](https://developer.android.com/reference/android/app/Notification#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/app/Notification#inhmethods)
# Notification
*** ** * ** ***
`
public
class
Notification
`
`
extends https://developer.android.com/reference/java/lang/Object
`
`
implements
https://developer.android.com/reference/android/os/Parcelable
`
|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.app.Notification |
*** ** * ** ***
A class that represents how a persistent notification is to be presented to
the user using the `https://developer.android.com/reference/android/app/NotificationManager`.
The `https://developer.android.com/reference/android/app/Notification.Builder` has been added to make it
easier to construct Notifications.
### Developer Guides
For a guide to creating notifications, read the
[Status Bar Notifications](https://developer.android.com/guide/topics/ui/notifiers/notifications)
developer guide.
## Summary
| ### Nested classes ||
|---|---|
| ` class` | `https://developer.android.com/reference/android/app/Notification.Action` Structure to encapsulate a named action that can be shown as part of this notification. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` Helper class for generating large-format notifications that include a large image attachment. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.BigTextStyle` Helper class for generating large-format notifications that include a lot of text. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.BridgedNotificationMetadata` Encapsulates the information needed to display a notification as a bridged notification. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.BubbleMetadata` Encapsulates the information needed to display a notification as a bubble. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.Builder` Builder class for `https://developer.android.com/reference/android/app/Notification` objects. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.CallStyle` Helper class for generating large-format notifications that include a caller and required actions, such as an incoming call with answer / decline. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.CarExtender`
Helper class to add Android Auto extensions to notifications. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.DecoratedCustomViewStyle` Notification style for custom views that are decorated by the system Instead of providing a notification that is completely custom, a developer can set this style and still obtain system decorations like the notification header with the expand affordance and actions. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.DecoratedMediaCustomViewStyle` Notification style for media custom views that are decorated by the system Instead of providing a media notification that is completely custom, a developer can set this style and still obtain system decorations like the notification header with the expand affordance and actions. |
| ` interface` | `https://developer.android.com/reference/android/app/Notification.Extender` Extender interface for use with `https://developer.android.com/reference/android/app/Notification.Builder#extend(android.app.Notification.Extender)`. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.InboxStyle` Helper class for generating large-format notifications that include a list of (up to 5) strings. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.MediaStyle` Notification style for media playback notifications. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.MessagingStyle` Helper class for generating large-format notifications that include multiple back-and-forth messages of varying types between any number of people. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.Metric` A metric, used with `https://developer.android.com/reference/android/app/Notification.MetricStyle`, and which has a value and a label. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.MetricStyle` A notification style which shows up to 3 metrics when expanded. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.ProgressStyle` A Notification Style used to define a notification whose expanded state includes a highly customizable progress bar with segments, points, a custom tracker icon, and custom icons at the start and end of the progress bar. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.ProjectedExtender` Helper class to add projection-specific extensions to a notification. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.Style` An object that can apply a rich notification style to a `https://developer.android.com/reference/android/app/Notification.Builder` object. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.TvExtender`
Helper class to add Android TV extensions to notifications. |
| ` class` | `https://developer.android.com/reference/android/app/Notification.WearableExtender` Helper class to add wearable extensions to notifications. |
| ### Constants ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#ACTION_BRIDGED_NOTIFICATION_PREFERENCES` An activity that provides a user interface for adjusting notification preferences for its bridged notification which originated on another device. |
| `int` | `https://developer.android.com/reference/android/app/Notification#BADGE_ICON_LARGE` If this notification is being shown as a badge, use the `https://developer.android.com/reference/android/app/Notification#getLargeIcon()` to represent this notification. |
| `int` | `https://developer.android.com/reference/android/app/Notification#BADGE_ICON_NONE` If this notification is being shown as a badge, always show as a number. |
| `int` | `https://developer.android.com/reference/android/app/Notification#BADGE_ICON_SMALL` If this notification is being shown as a badge, use the `https://developer.android.com/reference/android/app/Notification#getSmallIcon()` to represent this notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_ALARM` Notification category: alarm or timer. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_CALL` Notification category: incoming call (voice or video) or similar synchronous communication request. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_EMAIL` Notification category: asynchronous bulk message (email). |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_ERROR` Notification category: error in background operation or authentication status. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_EVENT` Notification category: calendar event. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_LOCATION_SHARING` Notification category: temporarily sharing location. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_MESSAGE` Notification category: incoming direct message (SMS, instant message, etc.). |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_MISSED_CALL` Notification category: missed call. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_NAVIGATION` Notification category: map turn-by-turn navigation. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_PROGRESS` Notification category: progress of a long-running background operation. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_PROMO` Notification category: promotion or advertisement. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_RECOMMENDATION` Notification category: a specific, timely recommendation for a single thing. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_REMINDER` Notification category: user-scheduled reminder. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_SERVICE` Notification category: indication of running background service. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_SOCIAL` Notification category: social network or sharing update. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_STATUS` Notification category: ongoing information about device or contextual status. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_STOPWATCH` Notification category: running stopwatch. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_SYSTEM` Notification category: system or device status update. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_TRANSPORT` Notification category: media transport control for playback. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_VOICEMAIL` Notification category: voicemail. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#CATEGORY_WORKOUT` Notification category: tracking a user's workout. |
| `int` | `https://developer.android.com/reference/android/app/Notification#COLOR_DEFAULT` Special value of `https://developer.android.com/reference/android/app/Notification#color` telling the system not to decorate this element with any special color (but instead use default system colors). |
| `int` | `https://developer.android.com/reference/android/app/Notification#DEFAULT_ALL` Use all default values (where applicable). |
| `int` | `https://developer.android.com/reference/android/app/Notification#DEFAULT_LIGHTS` Use the default notification lights. |
| `int` | `https://developer.android.com/reference/android/app/Notification#DEFAULT_SOUND` Use the default notification sound. |
| `int` | `https://developer.android.com/reference/android/app/Notification#DEFAULT_VIBRATE` Use the default notification vibrate. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_ANSWER_COLOR` `https://developer.android.com/reference/android/app/Notification#extras` key: the color used as a hint for the Answer action button of a `https://developer.android.com/reference/android/app/Notification.CallStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_ANSWER_INTENT` `https://developer.android.com/reference/android/app/Notification#extras` key: the intent to be sent when the users answers a `https://developer.android.com/reference/android/app/Notification.CallStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_AUDIO_CONTENTS_URI` `https://developer.android.com/reference/android/app/Notification#extras` key: the audio contents of this notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_BACKGROUND_IMAGE_URI` `https://developer.android.com/reference/android/app/Notification#extras` key: flat `https://developer.android.com/reference/java/lang/String` representation of a `https://developer.android.com/reference/android/content/ContentUris` pointing to an image that can be displayed in the background when the notification is selected. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_BIG_TEXT` `https://developer.android.com/reference/android/app/Notification#extras` key: this is the longer text shown in the expanded form of a `https://developer.android.com/reference/android/app/Notification.BigTextStyle` notification, as supplied to `https://developer.android.com/reference/android/app/Notification.BigTextStyle#bigText(java.lang.CharSequence)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_CALL_IS_VIDEO` `https://developer.android.com/reference/android/app/Notification#extras` key: whether the `https://developer.android.com/reference/android/app/Notification.CallStyle` notification is for a call that will activate video when answered. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_CALL_PERSON` `https://developer.android.com/reference/android/app/Notification#extras` key: the person to be displayed as calling for the `https://developer.android.com/reference/android/app/Notification.CallStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_CALL_TYPE` `https://developer.android.com/reference/android/app/Notification#extras` key: the type of call represented by the `https://developer.android.com/reference/android/app/Notification.CallStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_CHANNEL_GROUP_ID` Optional extra for `https://developer.android.com/reference/android/app/Notification#INTENT_CATEGORY_NOTIFICATION_PREFERENCES`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_CHANNEL_ID` Optional extra for `https://developer.android.com/reference/android/app/Notification#INTENT_CATEGORY_NOTIFICATION_PREFERENCES`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_CHRONOMETER_COUNT_DOWN` `https://developer.android.com/reference/android/app/Notification#extras` key: whether the chronometer set on the notification should count down instead of counting up. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_COLORIZED` `https://developer.android.com/reference/android/app/Notification#extras` key: whether the notification should be colorized as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setColorized(boolean)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_COMPACT_ACTIONS` `https://developer.android.com/reference/android/app/Notification#extras` key: the indices of actions to be shown in the compact view, as supplied to (e.g.) `https://developer.android.com/reference/android/app/Notification.MediaStyle#setShowActionsInCompactView(int[])`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_CONVERSATION_TITLE` `https://developer.android.com/reference/android/app/Notification#extras` key: a `https://developer.android.com/reference/java/lang/CharSequence` to be displayed as the title to a conversation represented by a `https://developer.android.com/reference/android/app/Notification.MessagingStyle` |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_DECLINE_COLOR` `https://developer.android.com/reference/android/app/Notification#extras` key: the color used as a hint for the Decline or Hang Up action button of a `https://developer.android.com/reference/android/app/Notification.CallStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_DECLINE_INTENT` `https://developer.android.com/reference/android/app/Notification#extras` key: the intent to be sent when the users declines a `https://developer.android.com/reference/android/app/Notification.CallStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_HANG_UP_INTENT` `https://developer.android.com/reference/android/app/Notification#extras` key: the intent to be sent when the users hangs up a `https://developer.android.com/reference/android/app/Notification.CallStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_HISTORIC_MESSAGES` `https://developer.android.com/reference/android/app/Notification#extras` key: an array of `https://developer.android.com/reference/android/app/Notification.MessagingStyle#addHistoricMessage(android.app.Notification.MessagingStyle.Message)` `https://developer.android.com/reference/android/app/Notification.MessagingStyle.Message` bundles provided by a `https://developer.android.com/reference/android/app/Notification.MessagingStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_INFO_TEXT` `https://developer.android.com/reference/android/app/Notification#extras` key: this is a small piece of additional text as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setContentInfo(java.lang.CharSequence)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_IS_GROUP_CONVERSATION` `https://developer.android.com/reference/android/app/Notification#extras` key: whether the `https://developer.android.com/reference/android/app/Notification.MessagingStyle` notification represents a group conversation. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_LARGE_ICON` *This constant was deprecated in API level 26. Use `https://developer.android.com/reference/android/app/Notification#getLargeIcon()`, which supports a wider variety of icon sources.* |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_LARGE_ICON_BIG` `https://developer.android.com/reference/android/app/Notification#extras` key: this is a bitmap to be used instead of the one from `https://developer.android.com/reference/android/app/Notification.Builder#setLargeIcon(android.graphics.Bitmap)` when the notification is shown in its expanded form, as supplied to `https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigLargeIcon(android.graphics.Bitmap)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_MEDIA_SESSION` `https://developer.android.com/reference/android/app/Notification#extras` key: A `https://developer.android.com/reference/android/media/session/MediaSession.Token` associated with a `https://developer.android.com/reference/android/app/Notification.MediaStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_MESSAGES` `https://developer.android.com/reference/android/app/Notification#extras` key: an array of `https://developer.android.com/reference/android/app/Notification.MessagingStyle.Message` bundles provided by a `https://developer.android.com/reference/android/app/Notification.MessagingStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_MESSAGING_PERSON` `https://developer.android.com/reference/android/app/Notification#extras` key: the person to be displayed for all messages sent by the user including direct replies `https://developer.android.com/reference/android/app/Notification.MessagingStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_NOTIFICATION_ID` Optional extra for `https://developer.android.com/reference/android/app/Notification#INTENT_CATEGORY_NOTIFICATION_PREFERENCES`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_NOTIFICATION_TAG` Optional extra for `https://developer.android.com/reference/android/app/Notification#INTENT_CATEGORY_NOTIFICATION_PREFERENCES`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_PEOPLE` *This constant was deprecated in API level 28. the actual objects are now in `https://developer.android.com/reference/android/app/Notification#EXTRA_PEOPLE_LIST`* |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_PEOPLE_LIST` `https://developer.android.com/reference/android/app/Notification#extras` key: An arrayList of `https://developer.android.com/reference/android/app/Person` objects containing the people that this notification relates to. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_PICTURE` `https://developer.android.com/reference/android/app/Notification#extras` key: this is a bitmap to be shown in `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` expanded notifications, supplied to `https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.Bitmap)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_PICTURE_CONTENT_DESCRIPTION` `https://developer.android.com/reference/android/app/Notification#extras` key: this is a content description of the big picture supplied from `https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.Bitmap)`, supplied to `https://developer.android.com/reference/android/app/Notification.BigPictureStyle#setContentDescription(java.lang.CharSequence)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_PICTURE_ICON` `https://developer.android.com/reference/android/app/Notification#extras` key: this is an `https://developer.android.com/reference/android/graphics/drawable/Icon` of an image to be shown in `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` expanded notifications, supplied to `https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.drawable.Icon)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_PREFER_SMALL_ICON` A boolean for `https://developer.android.com/reference/android/app/Notification#extras` requesting that the notification card show the small icon instead of the launcher app icon. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_PROGRESS` `https://developer.android.com/reference/android/app/Notification#extras` key: this is the progress value supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setProgress(int,%20int,%20boolean)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_PROGRESS_INDETERMINATE` `https://developer.android.com/reference/android/app/Notification#extras` key: whether the progress bar is indeterminate, supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setProgress(int,%20int,%20boolean)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_PROGRESS_MAX` `https://developer.android.com/reference/android/app/Notification#extras` key: this is the maximum value supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setProgress(int,%20int,%20boolean)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_REMOTE_INPUT_DRAFT` If the notification contained an unsent draft for a RemoteInput when the user clicked on it, we're adding the draft as a String extra to the `https://developer.android.com/reference/android/app/Notification#contentIntent` using this key. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_REMOTE_INPUT_HISTORY` `https://developer.android.com/reference/android/app/Notification#extras` key: this is the remote input history, as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setRemoteInputHistory(java.lang.CharSequence[])`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_REQUEST_PROMOTED_ONGOING` `https://developer.android.com/reference/android/app/Notification#extras` key: If provided, should contain a boolean indicating whether the notification is requesting promoted treatment. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_SELF_DISPLAY_NAME` *This constant was deprecated in API level 28. use `https://developer.android.com/reference/android/app/Notification#EXTRA_MESSAGING_PERSON`* |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_SHOW_BIG_PICTURE_WHEN_COLLAPSED` `https://developer.android.com/reference/android/app/Notification#extras` key: this is a boolean to indicate that the `https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.Bitmap)` is to be shown in the collapsed state of a `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_SHOW_CHRONOMETER` `https://developer.android.com/reference/android/app/Notification#extras` key: whether `https://developer.android.com/reference/android/app/Notification#when` should be shown as a count-up timer (specifically a `https://developer.android.com/reference/android/widget/Chronometer`) instead of a timestamp, as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setUsesChronometer(boolean)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_SHOW_WHEN` `https://developer.android.com/reference/android/app/Notification#extras` key: whether `https://developer.android.com/reference/android/app/Notification#when` should be shown, as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setShowWhen(boolean)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_SMALL_ICON` *This constant was deprecated in API level 26. Use `https://developer.android.com/reference/android/app/Notification#getSmallIcon()`, which supports a wider variety of icon sources.* |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_SUB_TEXT` `https://developer.android.com/reference/android/app/Notification#extras` key: this is a third line of text, as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setSubText(java.lang.CharSequence)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_SUMMARY_TEXT` `https://developer.android.com/reference/android/app/Notification#extras` key: this is a line of summary information intended to be shown alongside expanded notifications, as supplied to (e.g.) `https://developer.android.com/reference/android/app/Notification.BigTextStyle#setSummaryText(java.lang.CharSequence)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_TEMPLATE` `https://developer.android.com/reference/android/app/Notification#extras` key: A string representing the name of the specific `https://developer.android.com/reference/android/app/Notification.Style` used to create this notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_TEXT` `https://developer.android.com/reference/android/app/Notification#extras` key: this is the main text payload, as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setContentText(java.lang.CharSequence)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_TEXT_LINES` `https://developer.android.com/reference/android/app/Notification#extras` key: An array of CharSequences to show in `https://developer.android.com/reference/android/app/Notification.InboxStyle` expanded notifications, each of which was supplied to `https://developer.android.com/reference/android/app/Notification.InboxStyle#addLine(java.lang.CharSequence)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_TITLE` `https://developer.android.com/reference/android/app/Notification#extras` key: this is the title of the notification, as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setContentTitle(java.lang.CharSequence)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_TITLE_BIG` `https://developer.android.com/reference/android/app/Notification#extras` key: this is the title of the notification when shown in expanded form, e.g. as supplied to `https://developer.android.com/reference/android/app/Notification.BigTextStyle#setBigContentTitle(java.lang.CharSequence)`. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_VERIFICATION_ICON` `https://developer.android.com/reference/android/app/Notification#extras` key: the icon to be displayed as a verification status of the caller on a `https://developer.android.com/reference/android/app/Notification.CallStyle` notification. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#EXTRA_VERIFICATION_TEXT` `https://developer.android.com/reference/android/app/Notification#extras` key: the text to be displayed as a verification status of the caller on a `https://developer.android.com/reference/android/app/Notification.CallStyle` notification. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_AUTO_CANCEL` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be set if the notification should be canceled when it is clicked by the user. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_BUBBLE` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be set by the system if this notification is showing as a bubble. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_FOREGROUND_SERVICE` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be set if this notification represents a currently running service. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_GROUP_SUMMARY` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be set if this notification is the group summary for a group of notifications. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_HIGH_PRIORITY` *This constant was deprecated in API level 16. Use `https://developer.android.com/reference/android/app/Notification#priority` with a positive value.* |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_INSISTENT` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that if set, the audio will be repeated until the notification is cancelled or the notification window is opened. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_LOCAL_ONLY` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be set if this notification is relevant to the current device only and it is not recommended that it bridge to other devices. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_NO_CLEAR` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be set if the notification should not be canceled when the user clicks the Clear all button. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_ONGOING_EVENT` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be set if this notification is in reference to something that is ongoing, like a phone call. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_ONLY_ALERT_ONCE` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be set if you would only like the sound, vibrate and ticker to be played if the notification was not already showing. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_PROMOTED_ONGOING` Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be set by the system if this notification is a promoted ongoing notification, both because it `https://developer.android.com/reference/android/app/Notification#hasPromotableCharacteristics()` and the user has not disabled the feature for this app. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FLAG_SHOW_LIGHTS` *This constant was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()`.* |
| `int` | `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_DEFAULT` If the Notification associated with starting a foreground service has been built using `https://developer.android.com/reference/android/app/Notification.Builder#setForegroundServiceBehavior(int)` with this behavior, display of the notification will usually be suppressed for a short time to avoid visual disturbances to the user. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_DEFERRED` If the Notification associated with starting a foreground service has been built using `https://developer.android.com/reference/android/app/Notification.Builder#setForegroundServiceBehavior(int)` with this behavior, display of the notification will usually be suppressed for a short time to avoid visual disturbances to the user. |
| `int` | `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_IMMEDIATE` If the Notification associated with starting a foreground service has been built using `https://developer.android.com/reference/android/app/Notification.Builder#setForegroundServiceBehavior(int)` with this behavior, display of the notification will be immediate even if the default behavior would be to defer visibility for a short time. |
| `int` | `https://developer.android.com/reference/android/app/Notification#GROUP_ALERT_ALL` Constant for `https://developer.android.com/reference/android/app/Notification.Builder#setGroupAlertBehavior(int)`, meaning that all notifications in a group with sound or vibration ought to make sound or vibrate (respectively), so this notification will not be muted when it is in a group. |
| `int` | `https://developer.android.com/reference/android/app/Notification#GROUP_ALERT_CHILDREN` Constant for `https://developer.android.com/reference/android/app/Notification.Builder#setGroupAlertBehavior(int)`, meaning that the summary notification in a group should be silenced (no sound or vibration) even if they are posted to a `https://developer.android.com/reference/android/app/NotificationChannel` that has sound and/or vibration. |
| `int` | `https://developer.android.com/reference/android/app/Notification#GROUP_ALERT_SUMMARY` Constant for `https://developer.android.com/reference/android/app/Notification.Builder#setGroupAlertBehavior(int)`, meaning that all children notification in a group should be silenced (no sound or vibration) even if they are posted to a `https://developer.android.com/reference/android/app/NotificationChannel` that has sound and/or vibration. |
| `https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#INTENT_CATEGORY_NOTIFICATION_PREFERENCES` An activity that provides a user interface for adjusting notification preferences for its containing application. |
| `int` | `https://developer.android.com/reference/android/app/Notification#PRIORITY_DEFAULT` *This constant was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_DEFAULT` instead.* |
| `int` | `https://developer.android.com/reference/android/app/Notification#PRIORITY_HIGH` *This constant was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_HIGH` instead.* |
| `int` | `https://developer.android.com/reference/android/app/Notification#PRIORITY_LOW` *This constant was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_LOW` instead.* |
| `int` | `https://developer.android.com/reference/android/app/Notification#PRIORITY_MAX` *This constant was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_HIGH` instead.* |
| `int` | `https://developer.android.com/reference/android/app/Notification#PRIORITY_MIN` *This constant was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_MIN` instead.* |
| `int` | `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_CAUTION` This value is used to annotate an element as indicating caution, moderate urgency, tardiness, or another \\u201cintermediate\\u201d value on the semantic hierarchy. |
| `int` | `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_DANGER` This value is used to annotate an element as indicating danger, extreme urgency or lateness, or another \\u201cextreme\\u201d value on the semantic hierarchy. |
| `int` | `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_INFO` This value is used to annotate an element as indicating information that should stand out from other content, but which doesn\\u2019t fall on a scale or hierarchy. |
| `int` | `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_SAFE` This value is used to annotate an element as indicating safety, non-urgency, timeliness, or another \\u201cmild\\u201d value on the semantic hierarchy. |
| `int` | `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_UNSPECIFIED` This is the default value for semantic style, signaling no particular semantics. |
| `int` | `https://developer.android.com/reference/android/app/Notification#STREAM_DEFAULT` *This constant was deprecated in API level 21. Use `https://developer.android.com/reference/android/app/NotificationChannel#getAudioAttributes()` instead.* |
| `int` | `https://developer.android.com/reference/android/app/Notification#VISIBILITY_PRIVATE` Notification visibility: Show this notification on all lockscreens, but conceal sensitive or private information on secure lockscreens. |
| `int` | `https://developer.android.com/reference/android/app/Notification#VISIBILITY_PUBLIC` Notification visibility: Show this notification in its entirety on all lockscreens and while screen sharing. |
| `int` | `https://developer.android.com/reference/android/app/Notification#VISIBILITY_SECRET` Notification visibility: Do not reveal any part of this notification on a secure lockscreen or while screen sharing. |
### Inherited constants
From interface `https://developer.android.com/reference/android/os/Parcelable` `int` `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR`
Descriptor bit used with `https://developer.android.com/reference/android/os/Parcelable#describeContents()`: indicates that
the Parcelable object's flattened representation includes a file descriptor.
`int` `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE`
Flag for use with `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`: the object being written
is a return value, that is the result of a function such as
"`Parcelable someFunction()`",
"`void someFunction(out Parcelable)`", or
"`void someFunction(inout Parcelable)`".
| ### Fields ||
|---|---|
| ` public static final https://developer.android.com/reference/android/media/AudioAttributes` | `https://developer.android.com/reference/android/app/Notification#AUDIO_ATTRIBUTES_DEFAULT` The default value of `https://developer.android.com/reference/android/app/Notification#audioAttributes`. |
| ` public static final https://developer.android.com/reference/android/os/Parcelable.Creator` | `https://developer.android.com/reference/android/app/Notification#CREATOR` Parcelable.Creator that instantiates Notification objects |
| ` public https://developer.android.com/reference/android/app/Notification.Action` | `https://developer.android.com/reference/android/app/Notification#actions` Array of all `https://developer.android.com/reference/android/app/Notification.Action` structures attached to this notification by `https://developer.android.com/reference/android/app/Notification.Builder#addAction(int,%20java.lang.CharSequence,%20android.app.PendingIntent)`. |
| ` public https://developer.android.com/reference/android/media/AudioAttributes` | `https://developer.android.com/reference/android/app/Notification#audioAttributes` *This field was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationChannel#getAudioAttributes()` instead.* |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#audioStreamType` *This field was deprecated in API level 21. Use `https://developer.android.com/reference/android/app/Notification#audioAttributes` instead.* |
| ` public https://developer.android.com/reference/android/widget/RemoteViews` | `https://developer.android.com/reference/android/app/Notification#bigContentView` A large-format version of `https://developer.android.com/reference/android/app/Notification#contentView`, giving the Notification an opportunity to show more detail when expanded. |
| ` public https://developer.android.com/reference/java/lang/String` | `https://developer.android.com/reference/android/app/Notification#category` One of the predefined notification categories (see the `CATEGORY_*` constants) that best describes this Notification. |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#color` Accent color (an ARGB integer like the constants in `https://developer.android.com/reference/android/graphics/Color`) to be applied by the standard Style templates when presenting this notification. |
| ` public https://developer.android.com/reference/android/app/PendingIntent` | `https://developer.android.com/reference/android/app/Notification#contentIntent` The intent to execute when the expanded status entry is clicked. |
| ` public https://developer.android.com/reference/android/widget/RemoteViews` | `https://developer.android.com/reference/android/app/Notification#contentView` The view that will represent this notification in the notification list (which is pulled down from the status bar). |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#defaults` *This field was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationChannel#getSound()` and `https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()` and `https://developer.android.com/reference/android/app/NotificationChannel#shouldVibrate()`.* |
| ` public https://developer.android.com/reference/android/app/PendingIntent` | `https://developer.android.com/reference/android/app/Notification#deleteIntent` The intent to execute when the notification is explicitly dismissed by the user, either with the "Clear All" button or by swiping it away individually. |
| ` public https://developer.android.com/reference/android/os/Bundle` | `https://developer.android.com/reference/android/app/Notification#extras` Additional semantic data to be carried around with this Notification. |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#flags` |
| ` public https://developer.android.com/reference/android/app/PendingIntent` | `https://developer.android.com/reference/android/app/Notification#fullScreenIntent` An intent to launch instead of posting the notification to the status bar. |
| ` public https://developer.android.com/reference/android/widget/RemoteViews` | `https://developer.android.com/reference/android/app/Notification#headsUpContentView` A medium-format version of `https://developer.android.com/reference/android/app/Notification#contentView`, providing the Notification an opportunity to add action buttons to contentView. |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#icon` *This field was deprecated in API level 23. Use `https://developer.android.com/reference/android/app/Notification.Builder#setSmallIcon(android.graphics.drawable.Icon)` instead.* |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#iconLevel` If the icon in the status bar is to have more than one level, you can set this. |
| ` public https://developer.android.com/reference/android/graphics/Bitmap` | `https://developer.android.com/reference/android/app/Notification#largeIcon` *This field was deprecated in API level 23. Use `https://developer.android.com/reference/android/app/Notification.Builder#setLargeIcon(android.graphics.drawable.Icon)` instead.* |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#ledARGB` *This field was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()`.* |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#ledOffMS` *This field was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()`.* |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#ledOnMS` *This field was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()`.* |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#number` The number of events that this notification represents. |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#priority` *This field was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationChannel#getImportance()` instead.* |
| ` public https://developer.android.com/reference/android/app/Notification` | `https://developer.android.com/reference/android/app/Notification#publicVersion` Replacement version of this notification whose content will be shown in an insecure context such as atop a secure keyguard. |
| ` public https://developer.android.com/reference/android/net/Uri` | `https://developer.android.com/reference/android/app/Notification#sound` *This field was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationChannel#getSound()`.* |
| ` public https://developer.android.com/reference/java/lang/CharSequence` | `https://developer.android.com/reference/android/app/Notification#tickerText` Text that summarizes this notification for accessibility services. |
| ` public https://developer.android.com/reference/android/widget/RemoteViews` | `https://developer.android.com/reference/android/app/Notification#tickerView` Formerly, a view showing the `https://developer.android.com/reference/android/app/Notification#tickerText`. |
| ` public long[]` | `https://developer.android.com/reference/android/app/Notification#vibrate` *This field was deprecated in API level 26. use `https://developer.android.com/reference/android/app/NotificationChannel#getVibrationPattern()`.* |
| ` public int` | `https://developer.android.com/reference/android/app/Notification#visibility` Sphere of visibility of this notification, which affects how and when the SystemUI reveals the notification's presence and contents in untrusted situations (namely, on the secure lockscreen and during screen sharing). |
| ` public long` | `https://developer.android.com/reference/android/app/Notification#when` A timestamp related to this notification, in milliseconds since the epoch. |
| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/app/Notification#Notification()() ` Constructs a Notification object with default values. |
| ` https://developer.android.com/reference/android/app/Notification#Notification(android.os.Parcel)(https://developer.android.com/reference/android/os/Parcel parcel) ` Unflatten the notification from a parcel. |
| ` https://developer.android.com/reference/android/app/Notification#Notification(int,%20java.lang.CharSequence,%20long)(int icon, https://developer.android.com/reference/java/lang/CharSequence tickerText, long when) ` *This constructor is deprecated. Use `https://developer.android.com/reference/android/app/Notification.Builder` instead.* |
| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/app/Notification` | ` https://developer.android.com/reference/android/app/Notification#clone()() ` Creates and returns a copy of this object. |
| ` static https://developer.android.com/reference/android/text/Annotation` | ` https://developer.android.com/reference/android/app/Notification#createSemanticStyleAnnotation(int)(int semanticStyle) ` Constructs an `https://developer.android.com/reference/android/text/Annotation` that can be used to span text in a `https://developer.android.com/reference/android/text/Spanned` `https://developer.android.com/reference/java/lang/CharSequence` in some Notification text fields, and which may then be converted into styling of that section of text in order to indicate the semantic style. |
| ` int` | ` https://developer.android.com/reference/android/app/Notification#describeContents()() ` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
| ` https://developer.android.com/reference/android/util/Pair` | ` https://developer.android.com/reference/android/app/Notification#findRemoteInputActionPair(boolean)(boolean requiresFreeform) ` Finds and returns a remote input and its corresponding action. |
| ` boolean` | ` https://developer.android.com/reference/android/app/Notification#getAllowSystemGeneratedContextualActions()() ` Returns whether the platform is allowed (by the app developer) to generate contextual actions for this notification. |
| ` int` | ` https://developer.android.com/reference/android/app/Notification#getBadgeIconType()() ` Returns what icon should be shown for this notification if it is being displayed in a Launcher that supports badging. |
| ` https://developer.android.com/reference/android/app/Notification.BridgedNotificationMetadata` | ` https://developer.android.com/reference/android/app/Notification#getBridgedNotificationMetadata()() ` Returns the metadata associated with a notification originating on another device. |
| ` https://developer.android.com/reference/android/app/Notification.BubbleMetadata` | ` https://developer.android.com/reference/android/app/Notification#getBubbleMetadata()() ` Returns the bubble metadata that will be used to display app content in a floating window over the existing foreground activity. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/app/Notification#getChannelId()() ` Returns the id of the channel this notification posts to. |
| ` https://developer.android.com/reference/java/util/List` | ` https://developer.android.com/reference/android/app/Notification#getContextualActions()() ` Returns the actions that are contextual (that is, suggested because of the content of the notification) out of the actions in this notification. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/app/Notification#getGroup()() ` Get the key used to group this notification into a cluster or stack with other notifications on devices which support such rendering. |
| ` int` | ` https://developer.android.com/reference/android/app/Notification#getGroupAlertBehavior()() ` Returns which type of notifications in a group are responsible for audibly alerting the user. |
| ` https://developer.android.com/reference/android/graphics/drawable/Icon` | ` https://developer.android.com/reference/android/app/Notification#getLargeIcon()() ` The large icon shown in this notification's content view. |
| ` https://developer.android.com/reference/android/content/LocusId` | ` https://developer.android.com/reference/android/app/Notification#getLocusId()() ` Gets the `https://developer.android.com/reference/android/content/LocusId` associated with this notification. |
| ` https://developer.android.com/reference/java/lang/CharSequence` | ` https://developer.android.com/reference/android/app/Notification#getSettingsText()() ` Returns the settings text provided to `https://developer.android.com/reference/android/app/Notification.Builder#setSettingsText(java.lang.CharSequence)`. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/app/Notification#getShortCriticalText()() ` Returns the very short text summarizing the most critical information contained in the notification, or `null` if this field was not set. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/app/Notification#getShortcutId()() ` Returns the `https://developer.android.com/reference/android/content/pm/ShortcutInfo#getId()` that this notification supersedes, if any. |
| ` https://developer.android.com/reference/android/graphics/drawable/Icon` | ` https://developer.android.com/reference/android/app/Notification#getSmallIcon()() ` The small icon representing this notification in the status bar. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/app/Notification#getSortKey()() ` Get a sort key that orders this notification among other notifications from the same package. |
| ` long` | ` https://developer.android.com/reference/android/app/Notification#getTimeoutAfter()() ` Returns the duration from posting after which this notification should be canceled by the system, if it's not canceled already. |
| ` boolean` | ` https://developer.android.com/reference/android/app/Notification#hasImage()() ` |
| ` boolean` | ` https://developer.android.com/reference/android/app/Notification#hasPromotableCharacteristics()() ` Returns whether the notification has all the characteristics that make it eligible for `https://developer.android.com/reference/android/app/Notification#FLAG_PROMOTED_ONGOING`. |
| ` boolean` | ` https://developer.android.com/reference/android/app/Notification#hasSummarizedContent()() ` Returns whether this notification contains computationally summarized text. |
| ` boolean` | ` https://developer.android.com/reference/android/app/Notification#isRequestPromotedOngoing()() ` Returns whether this notification has requested to be a promoted ongoing notification. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/app/Notification#toString()() ` Returns a string representation of the object. |
| ` void` | ` https://developer.android.com/reference/android/app/Notification#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel parcel, int flags) ` Flatten this notification into a parcel. |
### Inherited methods
From class `
https://developer.android.com/reference/java/lang/Object
` `
https://developer.android.com/reference/java/lang/Object` `
https://developer.android.com/reference/java/lang/Object#clone()()
`
Creates and returns a copy of this object.
`
boolean` `
https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj)
`
Indicates whether some other object is "equal to" this one.
`
void` `
https://developer.android.com/reference/java/lang/Object#finalize()()
`
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
`
final
https://developer.android.com/reference/java/lang/Class` `
https://developer.android.com/reference/java/lang/Object#getClass()()
`
Returns the runtime class of this `Object`.
`
int` `
https://developer.android.com/reference/java/lang/Object#hashCode()()
`
Returns a hash code value for the object.
`
final
void` `
https://developer.android.com/reference/java/lang/Object#notify()()
`
Wakes up a single thread that is waiting on this object's
monitor.
`
final
void` `
https://developer.android.com/reference/java/lang/Object#notifyAll()()
`
Wakes up all threads that are waiting on this object's monitor.
`
https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Object#toString()()
`
Returns a string representation of the object.
`
final
void` `
https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos)
`
Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*, or until a
certain amount of real time has elapsed.
`
final
void` `
https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis)
`
Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*, or until a
certain amount of real time has elapsed.
`
final
void` `
https://developer.android.com/reference/java/lang/Object#wait()()
`
Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*.
From interface `
https://developer.android.com/reference/android/os/Parcelable
` `
abstract
int` `
https://developer.android.com/reference/android/os/Parcelable#describeContents()()
`
Describe the kinds of special objects contained in this Parcelable
instance's marshaled representation.
`
abstract
void` `
https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel dest, int flags)
`
Flatten this object in to a Parcel.
## Constants
### ACTION_BRIDGED_NOTIFICATION_PREFERENCES
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String ACTION_BRIDGED_NOTIFICATION_PREFERENCES
```
An activity that provides a user interface for adjusting notification preferences for its
bridged notification which originated on another device.
Constant Value:
"android.app.action.BRIDGED_NOTIFICATION_PREFERENCES"
### BADGE_ICON_LARGE
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int BADGE_ICON_LARGE
```
If this notification is being shown as a badge, use the `https://developer.android.com/reference/android/app/Notification#getLargeIcon()` to
represent this notification.
Constant Value:
2
(0x00000002)
### BADGE_ICON_NONE
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int BADGE_ICON_NONE
```
If this notification is being shown as a badge, always show as a number.
Constant Value:
0
(0x00000000)
### BADGE_ICON_SMALL
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int BADGE_ICON_SMALL
```
If this notification is being shown as a badge, use the `https://developer.android.com/reference/android/app/Notification#getSmallIcon()` to
represent this notification.
Constant Value:
1
(0x00000001)
### CATEGORY_ALARM
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_ALARM
```
Notification category: alarm or timer.
Constant Value:
"alarm"
### CATEGORY_CALL
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_CALL
```
Notification category: incoming call (voice or video) or similar synchronous communication request.
Constant Value:
"call"
### CATEGORY_EMAIL
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_EMAIL
```
Notification category: asynchronous bulk message (email).
Constant Value:
"email"
### CATEGORY_ERROR
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_ERROR
```
Notification category: error in background operation or authentication status.
Constant Value:
"err"
### CATEGORY_EVENT
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_EVENT
```
Notification category: calendar event.
Constant Value:
"event"
### CATEGORY_LOCATION_SHARING
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_LOCATION_SHARING
```
Notification category: temporarily sharing location.
Constant Value:
"location_sharing"
### CATEGORY_MESSAGE
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_MESSAGE
```
Notification category: incoming direct message (SMS, instant message, etc.).
Constant Value:
"msg"
### CATEGORY_MISSED_CALL
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_MISSED_CALL
```
Notification category: missed call.
Constant Value:
"missed_call"
### CATEGORY_NAVIGATION
Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_NAVIGATION
```
Notification category: map turn-by-turn navigation.
Constant Value:
"navigation"
### CATEGORY_PROGRESS
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_PROGRESS
```
Notification category: progress of a long-running background operation.
Constant Value:
"progress"
### CATEGORY_PROMO
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_PROMO
```
Notification category: promotion or advertisement.
Constant Value:
"promo"
### CATEGORY_RECOMMENDATION
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_RECOMMENDATION
```
Notification category: a specific, timely recommendation for a single thing.
For example, a news app might want to recommend a news story it believes the user will
want to read next.
Constant Value:
"recommendation"
### CATEGORY_REMINDER
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_REMINDER
```
Notification category: user-scheduled reminder.
Constant Value:
"reminder"
### CATEGORY_SERVICE
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_SERVICE
```
Notification category: indication of running background service.
Constant Value:
"service"
### CATEGORY_SOCIAL
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_SOCIAL
```
Notification category: social network or sharing update.
Constant Value:
"social"
### CATEGORY_STATUS
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_STATUS
```
Notification category: ongoing information about device or contextual status.
Constant Value:
"status"
### CATEGORY_STOPWATCH
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_STOPWATCH
```
Notification category: running stopwatch.
Constant Value:
"stopwatch"
### CATEGORY_SYSTEM
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_SYSTEM
```
Notification category: system or device status update. Reserved for system use.
Constant Value:
"sys"
### CATEGORY_TRANSPORT
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_TRANSPORT
```
Notification category: media transport control for playback.
Constant Value:
"transport"
### CATEGORY_VOICEMAIL
Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_VOICEMAIL
```
Notification category: voicemail.
Constant Value:
"voicemail"
### CATEGORY_WORKOUT
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String CATEGORY_WORKOUT
```
Notification category: tracking a user's workout.
Constant Value:
"workout"
### COLOR_DEFAULT
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int COLOR_DEFAULT
```
Special value of `https://developer.android.com/reference/android/app/Notification#color` telling the system not to decorate this element with
any special color (but instead use default system colors).
Constant Value:
0
(0x00000000)
### DEFAULT_ALL
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int DEFAULT_ALL
```
Use all default values (where applicable).
Constant Value:
-1
(0xffffffff)
### DEFAULT_LIGHTS
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int DEFAULT_LIGHTS
```
Use the default notification lights. This will ignore the
`https://developer.android.com/reference/android/app/Notification#FLAG_SHOW_LIGHTS` bit, and `https://developer.android.com/reference/android/app/Notification#ledARGB`, `https://developer.android.com/reference/android/app/Notification#ledOffMS`, or
`https://developer.android.com/reference/android/app/Notification#ledOnMS`.
**See also:**
- `https://developer.android.com/reference/android/app/Notification#defaults`
Constant Value:
4
(0x00000004)
### DEFAULT_SOUND
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int DEFAULT_SOUND
```
Use the default notification sound. This will ignore any given
`https://developer.android.com/reference/android/app/Notification#sound`.
A notification that is noisy is more likely to be presented as a heads-up notification.
**See also:**
- `https://developer.android.com/reference/android/app/Notification#defaults`
Constant Value:
1
(0x00000001)
### DEFAULT_VIBRATE
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int DEFAULT_VIBRATE
```
Use the default notification vibrate. This will ignore any given
`https://developer.android.com/reference/android/app/Notification#vibrate`. Using phone vibration requires the
`https://developer.android.com/reference/android/Manifest.permission#VIBRATE` permission.
A notification that vibrates is more likely to be presented as a heads-up notification.
**See also:**
- `https://developer.android.com/reference/android/app/Notification#defaults`
Constant Value:
2
(0x00000002)
### EXTRA_ANSWER_COLOR
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_ANSWER_COLOR
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the color used as a hint for the Answer action button of a
`https://developer.android.com/reference/android/app/Notification.CallStyle` notification. This extra is a `ColorInt`.
Constant Value:
"android.answerColor"
### EXTRA_ANSWER_INTENT
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_ANSWER_INTENT
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the intent to be sent when the users answers a
`https://developer.android.com/reference/android/app/Notification.CallStyle` notification. This extra is a
`https://developer.android.com/reference/android/app/PendingIntent`.
Constant Value:
"android.answerIntent"
### EXTRA_AUDIO_CONTENTS_URI
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_AUDIO_CONTENTS_URI
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the audio contents of this notification.
This is for use when rendering the notification on an audio-focused interface;
the audio contents are a complete sound sample that contains the contents/body of the
notification. This may be used in substitute of a Text-to-Speech reading of the
notification. For example if the notification represents a voice message this should point
to the audio of that message.
The data stored under this key should be a String representation of a Uri that contains
the audio contents in one of the following formats: WAV, PCM 16-bit, AMR-WB.
This extra is unnecessary if you are using `https://developer.android.com/reference/android/app/Notification.MessagingStyle` since each
`https://developer.android.com/reference/android/app/Notification.MessagingStyle.Message` has a field for holding data URI. That field can be used for
audio. See `https://developer.android.com/reference/android/app/Notification.MessagingStyle.Message#setData(java.lang.String,%20android.net.Uri)`.
Example usage:
Notification.Builder myBuilder = (build your Notification as normal);
myBuilder.getExtras().putString(EXTRA_AUDIO_CONTENTS_URI, myAudioUri.toString());
Constant Value:
"android.audioContents"
### EXTRA_BACKGROUND_IMAGE_URI
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_BACKGROUND_IMAGE_URI
```
`https://developer.android.com/reference/android/app/Notification#extras` key:
flat `https://developer.android.com/reference/java/lang/String` representation of a `https://developer.android.com/reference/android/content/ContentUris`
pointing to an image that can be displayed in the background when the notification is
selected. Used on television platforms. The URI must point to an image stream suitable for
passing into `https://developer.android.com/reference/android/graphics/BitmapFactory#decodeStream(java.io.InputStream)`; all other content types will be ignored.
Constant Value:
"android.backgroundImageUri"
### EXTRA_BIG_TEXT
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_BIG_TEXT
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is the longer text shown in the expanded form of a
`https://developer.android.com/reference/android/app/Notification.BigTextStyle` notification, as supplied to
`https://developer.android.com/reference/android/app/Notification.BigTextStyle#bigText(java.lang.CharSequence)`.
Constant Value:
"android.bigText"
### EXTRA_CALL_IS_VIDEO
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_CALL_IS_VIDEO
```
`https://developer.android.com/reference/android/app/Notification#extras` key: whether the `https://developer.android.com/reference/android/app/Notification.CallStyle` notification
is for a call that will activate video when answered. This extra is a boolean.
Constant Value:
"android.callIsVideo"
### EXTRA_CALL_PERSON
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_CALL_PERSON
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the person to be displayed as calling for the
`https://developer.android.com/reference/android/app/Notification.CallStyle` notification. This extra is a `https://developer.android.com/reference/android/app/Person`.
Constant Value:
"android.callPerson"
### EXTRA_CALL_TYPE
Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_CALL_TYPE
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the type of call represented by the
`https://developer.android.com/reference/android/app/Notification.CallStyle` notification. This extra is an int.
Constant Value:
"android.callType"
### EXTRA_CHANNEL_GROUP_ID
Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_CHANNEL_GROUP_ID
```
Optional extra for `https://developer.android.com/reference/android/app/Notification#INTENT_CATEGORY_NOTIFICATION_PREFERENCES`. If provided, will
contain a `https://developer.android.com/reference/android/app/NotificationChannelGroup#getId()` that can be used to narrow down
what settings should be shown in the target app.
Constant Value:
"android.intent.extra.CHANNEL_GROUP_ID"
### EXTRA_CHANNEL_ID
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_CHANNEL_ID
```
Optional extra for `https://developer.android.com/reference/android/app/Notification#INTENT_CATEGORY_NOTIFICATION_PREFERENCES`. If provided, will
contain a `https://developer.android.com/reference/android/app/NotificationChannel#getId()` that can be used to narrow down
what settings should be shown in the target app.
Constant Value:
"android.intent.extra.CHANNEL_ID"
### EXTRA_CHRONOMETER_COUNT_DOWN
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_CHRONOMETER_COUNT_DOWN
```
`https://developer.android.com/reference/android/app/Notification#extras` key: whether the chronometer set on the notification should count down
instead of counting up. Is only relevant if key `https://developer.android.com/reference/android/app/Notification#EXTRA_SHOW_CHRONOMETER` is present.
This extra is a boolean. The default is `false`.
Constant Value:
"android.chronometerCountDown"
### EXTRA_COLORIZED
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_COLORIZED
```
`https://developer.android.com/reference/android/app/Notification#extras` key: whether the notification should be colorized as
supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setColorized(boolean)`.
Constant Value:
"android.colorized"
### EXTRA_COMPACT_ACTIONS
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_COMPACT_ACTIONS
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the indices of actions to be shown in the compact view,
as supplied to (e.g.) `https://developer.android.com/reference/android/app/Notification.MediaStyle#setShowActionsInCompactView(int[])`.
Constant Value:
"android.compactActions"
### EXTRA_CONVERSATION_TITLE
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_CONVERSATION_TITLE
```
`https://developer.android.com/reference/android/app/Notification#extras` key: a `https://developer.android.com/reference/java/lang/CharSequence` to be displayed as the title to a conversation
represented by a `https://developer.android.com/reference/android/app/Notification.MessagingStyle`
Constant Value:
"android.conversationTitle"
### EXTRA_DECLINE_COLOR
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_DECLINE_COLOR
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the color used as a hint for the Decline or Hang Up action button of a
`https://developer.android.com/reference/android/app/Notification.CallStyle` notification. This extra is a `ColorInt`.
Constant Value:
"android.declineColor"
### EXTRA_DECLINE_INTENT
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_DECLINE_INTENT
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the intent to be sent when the users declines a
`https://developer.android.com/reference/android/app/Notification.CallStyle` notification. This extra is a
`https://developer.android.com/reference/android/app/PendingIntent`.
Constant Value:
"android.declineIntent"
### EXTRA_HANG_UP_INTENT
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_HANG_UP_INTENT
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the intent to be sent when the users hangs up a
`https://developer.android.com/reference/android/app/Notification.CallStyle` notification. This extra is a
`https://developer.android.com/reference/android/app/PendingIntent`.
Constant Value:
"android.hangUpIntent"
### EXTRA_HISTORIC_MESSAGES
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_HISTORIC_MESSAGES
```
`https://developer.android.com/reference/android/app/Notification#extras` key: an array of
`https://developer.android.com/reference/android/app/Notification.MessagingStyle#addHistoricMessage(android.app.Notification.MessagingStyle.Message)`
`https://developer.android.com/reference/android/app/Notification.MessagingStyle.Message` bundles provided by a
`https://developer.android.com/reference/android/app/Notification.MessagingStyle` notification. This extra is a parcelable
array of bundles.
Constant Value:
"android.messages.historic"
### EXTRA_INFO_TEXT
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_INFO_TEXT
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is a small piece of additional text as supplied to
`https://developer.android.com/reference/android/app/Notification.Builder#setContentInfo(java.lang.CharSequence)`.
Constant Value:
"android.infoText"
### EXTRA_IS_GROUP_CONVERSATION
Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_IS_GROUP_CONVERSATION
```
`https://developer.android.com/reference/android/app/Notification#extras` key: whether the `https://developer.android.com/reference/android/app/Notification.MessagingStyle` notification
represents a group conversation.
Constant Value:
"android.isGroupConversation"
### EXTRA_LARGE_ICON
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_LARGE_ICON
```
**This constant was deprecated
in API level 26.**
Use `https://developer.android.com/reference/android/app/Notification#getLargeIcon()`, which supports a wider variety of icon sources.
`https://developer.android.com/reference/android/app/Notification#extras` key: this is a bitmap to be used instead of the small icon when showing the
notification payload, as
supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setLargeIcon(android.graphics.Bitmap)`.
Constant Value:
"android.largeIcon"
### EXTRA_LARGE_ICON_BIG
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_LARGE_ICON_BIG
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is a bitmap to be used instead of the one from
`https://developer.android.com/reference/android/app/Notification.Builder#setLargeIcon(android.graphics.Bitmap)` when the notification is
shown in its expanded form, as supplied to
`https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigLargeIcon(android.graphics.Bitmap)`.
Constant Value:
"android.largeIcon.big"
### EXTRA_MEDIA_SESSION
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_MEDIA_SESSION
```
`https://developer.android.com/reference/android/app/Notification#extras` key: A
`https://developer.android.com/reference/android/media/session/MediaSession.Token` associated with a
`https://developer.android.com/reference/android/app/Notification.MediaStyle` notification.
Constant Value:
"android.mediaSession"
### EXTRA_MESSAGES
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_MESSAGES
```
`https://developer.android.com/reference/android/app/Notification#extras` key: an array of `https://developer.android.com/reference/android/app/Notification.MessagingStyle.Message`
bundles provided by a
`https://developer.android.com/reference/android/app/Notification.MessagingStyle` notification. This extra is a parcelable
array of bundles.
Constant Value:
"android.messages"
### EXTRA_MESSAGING_PERSON
Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_MESSAGING_PERSON
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the person to be displayed for all messages sent by the user including
direct replies
`https://developer.android.com/reference/android/app/Notification.MessagingStyle` notification. This extra is a
`https://developer.android.com/reference/android/app/Person`.
Constant Value:
"android.messagingUser"
### EXTRA_NOTIFICATION_ID
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_NOTIFICATION_ID
```
Optional extra for `https://developer.android.com/reference/android/app/Notification#INTENT_CATEGORY_NOTIFICATION_PREFERENCES`. If provided, will
contain the id provided to `https://developer.android.com/reference/android/app/NotificationManager#notify(java.lang.String,%20int,%20android.app.Notification)`
that can be used to narrow down what settings should be shown in the target app.
Constant Value:
"android.intent.extra.NOTIFICATION_ID"
### EXTRA_NOTIFICATION_TAG
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_NOTIFICATION_TAG
```
Optional extra for `https://developer.android.com/reference/android/app/Notification#INTENT_CATEGORY_NOTIFICATION_PREFERENCES`. If provided, will
contain the tag provided to `https://developer.android.com/reference/android/app/NotificationManager#notify(java.lang.String,%20int,%20android.app.Notification)`
that can be used to narrow down what settings should be shown in the target app.
Constant Value:
"android.intent.extra.NOTIFICATION_TAG"
### EXTRA_PEOPLE
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_PEOPLE
```
**This constant was deprecated
in API level 28.**
the actual objects are now in `https://developer.android.com/reference/android/app/Notification#EXTRA_PEOPLE_LIST`
`https://developer.android.com/reference/android/app/Notification#extras` key: A String array containing the people that this notification relates to,
each of which was supplied to `https://developer.android.com/reference/android/app/Notification.Builder#addPerson(java.lang.String)`.
Constant Value:
"android.people"
### EXTRA_PEOPLE_LIST
Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_PEOPLE_LIST
```
`https://developer.android.com/reference/android/app/Notification#extras` key: An arrayList of `https://developer.android.com/reference/android/app/Person` objects containing the people that
this notification relates to.
Constant Value:
"android.people.list"
### EXTRA_PICTURE
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_PICTURE
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is a bitmap to be shown in `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` expanded
notifications, supplied to `https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.Bitmap)`.
Constant Value:
"android.picture"
### EXTRA_PICTURE_CONTENT_DESCRIPTION
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_PICTURE_CONTENT_DESCRIPTION
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is a content description of the big picture supplied from
`https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.Bitmap)`, supplied to
`https://developer.android.com/reference/android/app/Notification.BigPictureStyle#setContentDescription(java.lang.CharSequence)`.
Constant Value:
"android.pictureContentDescription"
### EXTRA_PICTURE_ICON
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_PICTURE_ICON
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is an `https://developer.android.com/reference/android/graphics/drawable/Icon` of an image to be
shown in `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` expanded notifications, supplied to
`https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.drawable.Icon)`.
Constant Value:
"android.pictureIcon"
### EXTRA_PREFER_SMALL_ICON
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_PREFER_SMALL_ICON
```
A boolean for `https://developer.android.com/reference/android/app/Notification#extras` requesting that the notification card show the small icon
instead of the launcher app icon.
Constant Value:
"android.app.preferSmallIcon"
### EXTRA_PROGRESS
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_PROGRESS
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is the progress value supplied to
`https://developer.android.com/reference/android/app/Notification.Builder#setProgress(int,%20int,%20boolean)`.
Constant Value:
"android.progress"
### EXTRA_PROGRESS_INDETERMINATE
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_PROGRESS_INDETERMINATE
```
`https://developer.android.com/reference/android/app/Notification#extras` key: whether the progress bar is indeterminate, supplied to
`https://developer.android.com/reference/android/app/Notification.Builder#setProgress(int,%20int,%20boolean)`.
Constant Value:
"android.progressIndeterminate"
### EXTRA_PROGRESS_MAX
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_PROGRESS_MAX
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is the maximum value supplied to
`https://developer.android.com/reference/android/app/Notification.Builder#setProgress(int,%20int,%20boolean)`.
Constant Value:
"android.progressMax"
### EXTRA_REMOTE_INPUT_DRAFT
Added in [API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_REMOTE_INPUT_DRAFT
```
If the notification contained an unsent draft for a RemoteInput when the user clicked on it,
we're adding the draft as a String extra to the `https://developer.android.com/reference/android/app/Notification#contentIntent` using this key.
Apps may use this extra to prepopulate text fields in the app, where the user usually
sends messages.
Constant Value:
"android.remoteInputDraft"
### EXTRA_REMOTE_INPUT_HISTORY
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_REMOTE_INPUT_HISTORY
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is the remote input history, as supplied to
`https://developer.android.com/reference/android/app/Notification.Builder#setRemoteInputHistory(java.lang.CharSequence[])`.
Apps can fill this through `https://developer.android.com/reference/android/app/Notification.Builder#setRemoteInputHistory(java.lang.CharSequence[])`
with the most recent inputs that have been sent through a `https://developer.android.com/reference/android/app/RemoteInput` of this
Notification and are expected to clear it once the it is no longer relevant (e.g. for chat
notifications once the other party has responded).
The extra with this key is of type `CharSequence[]` and contains the most recent
entry at the 0 index, the second most recent at the 1 index, etc.
**See also:**
- `https://developer.android.com/reference/android/app/Notification.Builder#setRemoteInputHistory(java.lang.CharSequence[])`
Constant Value:
"android.remoteInputHistory"
### EXTRA_REQUEST_PROMOTED_ONGOING
Added in [version 36.1](https://developer.android.com/topic/libraries/support-library/revisions)
```
public static final String EXTRA_REQUEST_PROMOTED_ONGOING
```
`https://developer.android.com/reference/android/app/Notification#extras` key: If provided, should contain a boolean indicating
whether the notification is requesting promoted treatment.
Constant Value:
"android.requestPromotedOngoing"
### EXTRA_SELF_DISPLAY_NAME
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_SELF_DISPLAY_NAME
```
**This constant was deprecated
in API level 28.**
use `https://developer.android.com/reference/android/app/Notification#EXTRA_MESSAGING_PERSON`
`https://developer.android.com/reference/android/app/Notification#extras` key: the username to be displayed for all messages sent by the user including
direct replies
`https://developer.android.com/reference/android/app/Notification.MessagingStyle` notification. This extra is a
`https://developer.android.com/reference/java/lang/CharSequence`.
Constant Value:
"android.selfDisplayName"
### EXTRA_SHOW_BIG_PICTURE_WHEN_COLLAPSED
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_SHOW_BIG_PICTURE_WHEN_COLLAPSED
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is a boolean to indicate that the
`https://developer.android.com/reference/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.Bitmap)` is to be shown in the collapsed state
of a `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` notification. This will replace a
`https://developer.android.com/reference/android/app/Notification.Builder#setLargeIcon(android.graphics.drawable.Icon)` in that state if one was provided.
Constant Value:
"android.showBigPictureWhenCollapsed"
### EXTRA_SHOW_CHRONOMETER
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_SHOW_CHRONOMETER
```
`https://developer.android.com/reference/android/app/Notification#extras` key: whether `https://developer.android.com/reference/android/app/Notification#when` should be shown as a count-up timer (specifically
a `https://developer.android.com/reference/android/widget/Chronometer`) instead of a timestamp, as supplied to
`https://developer.android.com/reference/android/app/Notification.Builder#setUsesChronometer(boolean)`.
Constant Value:
"android.showChronometer"
### EXTRA_SHOW_WHEN
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_SHOW_WHEN
```
`https://developer.android.com/reference/android/app/Notification#extras` key: whether `https://developer.android.com/reference/android/app/Notification#when` should be shown,
as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setShowWhen(boolean)`.
Constant Value:
"android.showWhen"
### EXTRA_SMALL_ICON
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_SMALL_ICON
```
**This constant was deprecated
in API level 26.**
Use `https://developer.android.com/reference/android/app/Notification#getSmallIcon()`, which supports a wider variety of icon sources.
`https://developer.android.com/reference/android/app/Notification#extras` key: this is the resource ID of the notification's main small icon, as
supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setSmallIcon(int)`.
Constant Value:
"android.icon"
### EXTRA_SUB_TEXT
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_SUB_TEXT
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is a third line of text, as supplied to
`https://developer.android.com/reference/android/app/Notification.Builder#setSubText(java.lang.CharSequence)`.
Constant Value:
"android.subText"
### EXTRA_SUMMARY_TEXT
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_SUMMARY_TEXT
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is a line of summary information intended to be shown
alongside expanded notifications, as supplied to (e.g.)
`https://developer.android.com/reference/android/app/Notification.BigTextStyle#setSummaryText(java.lang.CharSequence)`.
Constant Value:
"android.summaryText"
### EXTRA_TEMPLATE
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_TEMPLATE
```
`https://developer.android.com/reference/android/app/Notification#extras` key: A string representing the name of the specific
`https://developer.android.com/reference/android/app/Notification.Style` used to create this notification.
Constant Value:
"android.template"
### EXTRA_TEXT
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_TEXT
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is the main text payload, as supplied to
`https://developer.android.com/reference/android/app/Notification.Builder#setContentText(java.lang.CharSequence)`.
Constant Value:
"android.text"
### EXTRA_TEXT_LINES
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_TEXT_LINES
```
`https://developer.android.com/reference/android/app/Notification#extras` key: An array of CharSequences to show in `https://developer.android.com/reference/android/app/Notification.InboxStyle` expanded
notifications, each of which was supplied to `https://developer.android.com/reference/android/app/Notification.InboxStyle#addLine(java.lang.CharSequence)`.
Constant Value:
"android.textLines"
### EXTRA_TITLE
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_TITLE
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is the title of the notification,
as supplied to `https://developer.android.com/reference/android/app/Notification.Builder#setContentTitle(java.lang.CharSequence)`.
Constant Value:
"android.title"
### EXTRA_TITLE_BIG
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_TITLE_BIG
```
`https://developer.android.com/reference/android/app/Notification#extras` key: this is the title of the notification when shown in expanded form,
e.g. as supplied to `https://developer.android.com/reference/android/app/Notification.BigTextStyle#setBigContentTitle(java.lang.CharSequence)`.
Constant Value:
"android.title.big"
### EXTRA_VERIFICATION_ICON
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_VERIFICATION_ICON
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the icon to be displayed as a verification status of the caller on a
`https://developer.android.com/reference/android/app/Notification.CallStyle` notification. This extra is an `https://developer.android.com/reference/android/graphics/drawable/Icon`.
Constant Value:
"android.verificationIcon"
### EXTRA_VERIFICATION_TEXT
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String EXTRA_VERIFICATION_TEXT
```
`https://developer.android.com/reference/android/app/Notification#extras` key: the text to be displayed as a verification status of the caller on a
`https://developer.android.com/reference/android/app/Notification.CallStyle` notification. This extra is a
`https://developer.android.com/reference/java/lang/CharSequence`.
Constant Value:
"android.verificationText"
### FLAG_AUTO_CANCEL
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_AUTO_CANCEL
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set if the notification should be canceled when it is clicked by the
user.
Constant Value:
16
(0x00000010)
### FLAG_BUBBLE
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_BUBBLE
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set by the system if this notification is showing as a bubble.
Applications cannot set this flag directly; they should instead call
`https://developer.android.com/reference/android/app/Notification.Builder#setBubbleMetadata(android.app.Notification.BubbleMetadata)` to
request that a notification be displayed as a bubble, and then check
this flag to see whether that request was honored by the system.
Constant Value:
4096
(0x00001000)
### FLAG_FOREGROUND_SERVICE
Added in [API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_FOREGROUND_SERVICE
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set if this notification represents a currently running service. This
will normally be set for you by `https://developer.android.com/reference/android/app/Service#startForeground(int,%20android.app.Notification)`.
Constant Value:
64
(0x00000040)
### FLAG_GROUP_SUMMARY
Added in [API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_GROUP_SUMMARY
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set if this notification is the group summary for a group of notifications.
Grouped notifications may display in a cluster or stack on devices which
support such rendering. Requires a group key also be set using `https://developer.android.com/reference/android/app/Notification.Builder#setGroup(java.lang.String)`.
Constant Value:
512
(0x00000200)
### FLAG_HIGH_PRIORITY
Added in [API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
16](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_HIGH_PRIORITY
```
**This constant was deprecated
in API level 16.**
Use `https://developer.android.com/reference/android/app/Notification#priority` with a positive value.
Obsolete flag indicating high-priority notifications; use the priority field instead.
Constant Value:
128
(0x00000080)
### FLAG_INSISTENT
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_INSISTENT
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that if set,
the audio will be repeated until the notification is
cancelled or the notification window is opened.
Constant Value:
4
(0x00000004)
### FLAG_LOCAL_ONLY
Added in [API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_LOCAL_ONLY
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set if this notification is relevant to the current device only
and it is not recommended that it bridge to other devices.
Constant Value:
256
(0x00000100)
### FLAG_NO_CLEAR
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_NO_CLEAR
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set if the notification should not be canceled when the user clicks
the Clear all button.
Constant Value:
32
(0x00000020)
### FLAG_ONGOING_EVENT
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_ONGOING_EVENT
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set if this notification is in reference to something that is ongoing,
like a phone call. It should not be set if this notification is in
reference to something that happened at a particular point in time,
like a missed phone call.
Constant Value:
2
(0x00000002)
### FLAG_ONLY_ALERT_ONCE
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_ONLY_ALERT_ONCE
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set if you would only like the sound, vibrate and ticker to be played
if the notification was not already showing.
Note that using this flag will stop any ongoing alerting behaviour such
as sound, vibration or blinking notification LED.
Constant Value:
8
(0x00000008)
### FLAG_PROMOTED_ONGOING
Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_PROMOTED_ONGOING
```
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set by the system if this notification is a promoted ongoing notification, both because it
`https://developer.android.com/reference/android/app/Notification#hasPromotableCharacteristics()` and the user has not disabled the feature for this
app.
Applications cannot set this flag directly, but the posting app and
`https://developer.android.com/reference/android/service/notification/NotificationListenerService` can read it.
Constant Value:
262144
(0x00040000)
### FLAG_SHOW_LIGHTS
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FLAG_SHOW_LIGHTS
```
**This constant was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()`.
Bit to be bitwise-ORed into the `https://developer.android.com/reference/android/app/Notification#flags` field that should be
set if you want the LED on for this notification.
- To turn the LED off, pass 0 in the alpha channel for colorARGB or 0 for both ledOnMS and ledOffMS.
- To turn the LED on, pass 1 for ledOnMS and 0 for ledOffMS.
- To flash the LED, pass the number of milliseconds that it should be on and off to ledOnMS and ledOffMS.
Since hardware varies, you are not guaranteed that any of the values
you pass are honored exactly. Use the system defaults if possible
because they will be set to values that work on any given hardware.
The alpha channel must be set for forward compatibility.
Constant Value:
1
(0x00000001)
### FOREGROUND_SERVICE_DEFAULT
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FOREGROUND_SERVICE_DEFAULT
```
If the Notification associated with starting a foreground service has been built using
`https://developer.android.com/reference/android/app/Notification.Builder#setForegroundServiceBehavior(int)` with this behavior, display
of the notification will usually be suppressed for a short time to avoid visual
disturbances to the user.
Value is one of the following:
- `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_DEFAULT`
- `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_IMMEDIATE`
- `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_DEFERRED`
- Constant Value: 0 (0x00000000)
### FOREGROUND_SERVICE_DEFERRED
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FOREGROUND_SERVICE_DEFERRED
```
If the Notification associated with starting a foreground service has been built using
`https://developer.android.com/reference/android/app/Notification.Builder#setForegroundServiceBehavior(int)` with this behavior, display
of the notification will usually be suppressed for a short time to avoid visual
disturbances to the user.
Value is one of the following:
- `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_DEFAULT`
- `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_IMMEDIATE`
- `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_DEFERRED`
- Constant Value: 2 (0x00000002)
### FOREGROUND_SERVICE_IMMEDIATE
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int FOREGROUND_SERVICE_IMMEDIATE
```
If the Notification associated with starting a foreground service has been built using
`https://developer.android.com/reference/android/app/Notification.Builder#setForegroundServiceBehavior(int)` with this behavior, display
of the notification will be immediate even if the default behavior would be
to defer visibility for a short time.
Value is one of the following:
- `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_DEFAULT`
- `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_IMMEDIATE`
- `https://developer.android.com/reference/android/app/Notification#FOREGROUND_SERVICE_DEFERRED`
- Constant Value: 1 (0x00000001)
### GROUP_ALERT_ALL
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int GROUP_ALERT_ALL
```
Constant for `https://developer.android.com/reference/android/app/Notification.Builder#setGroupAlertBehavior(int)`, meaning that all notifications in a
group with sound or vibration ought to make sound or vibrate (respectively), so this
notification will not be muted when it is in a group.
Constant Value:
0
(0x00000000)
### GROUP_ALERT_CHILDREN
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int GROUP_ALERT_CHILDREN
```
Constant for `https://developer.android.com/reference/android/app/Notification.Builder#setGroupAlertBehavior(int)`, meaning that the summary
notification in a group should be silenced (no sound or vibration) even if they are
posted to a `https://developer.android.com/reference/android/app/NotificationChannel` that has sound and/or vibration. Use this constant
to mute this notification if this notification is a group summary.
For example, you might want to use this constant if only the children notifications
in your group have content and the summary is only used to visually group notifications
rather than to alert the user that new information is available.
Constant Value:
2
(0x00000002)
### GROUP_ALERT_SUMMARY
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int GROUP_ALERT_SUMMARY
```
Constant for `https://developer.android.com/reference/android/app/Notification.Builder#setGroupAlertBehavior(int)`, meaning that all children
notification in a group should be silenced (no sound or vibration) even if they are posted
to a `https://developer.android.com/reference/android/app/NotificationChannel` that has sound and/or vibration. Use this constant to
mute this notification if this notification is a group child. This must be applied to all
children notifications you want to mute.
For example, you might want to use this constant if you post a number of children
notifications at once (say, after a periodic sync), and only need to notify the user
audibly once.
Constant Value:
1
(0x00000001)
### INTENT_CATEGORY_NOTIFICATION_PREFERENCES
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String INTENT_CATEGORY_NOTIFICATION_PREFERENCES
```
An activity that provides a user interface for adjusting notification preferences for its
containing application.
Constant Value:
"android.intent.category.NOTIFICATION_PREFERENCES"
### PRIORITY_DEFAULT
Added in [API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int PRIORITY_DEFAULT
```
**This constant was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_DEFAULT` instead.
Default notification `https://developer.android.com/reference/android/app/Notification#priority`. If your application does not prioritize its own
notifications, use this value for all notifications.
Constant Value:
0
(0x00000000)
### PRIORITY_HIGH
Added in [API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int PRIORITY_HIGH
```
**This constant was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_HIGH` instead.
Higher `https://developer.android.com/reference/android/app/Notification#priority`, for more important notifications or alerts. The UI may choose to
show these items larger, or at a different position in notification lists, compared with
your app's `https://developer.android.com/reference/android/app/Notification#PRIORITY_DEFAULT` items.
Constant Value:
1
(0x00000001)
### PRIORITY_LOW
Added in [API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int PRIORITY_LOW
```
**This constant was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_LOW` instead.
Lower `https://developer.android.com/reference/android/app/Notification#priority`, for items that are less important. The UI may choose to show these
items smaller, or at a different position in the list, compared with your app's
`https://developer.android.com/reference/android/app/Notification#PRIORITY_DEFAULT` items.
Constant Value:
-1
(0xffffffff)
### PRIORITY_MAX
Added in [API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int PRIORITY_MAX
```
**This constant was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_HIGH` instead.
Highest `https://developer.android.com/reference/android/app/Notification#priority`, for your application's most important items that require the
user's prompt attention or input.
Constant Value:
2
(0x00000002)
### PRIORITY_MIN
Added in [API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int PRIORITY_MIN
```
**This constant was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationManager#IMPORTANCE_MIN` instead.
Lowest `https://developer.android.com/reference/android/app/Notification#priority`; these items might not be shown to the user except under special
circumstances, such as detailed notification logs.
Constant Value:
-2
(0xfffffffe)
### SEMANTIC_STYLE_CAUTION
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int SEMANTIC_STYLE_CAUTION
```
This value is used to annotate an element as indicating caution, moderate urgency, tardiness,
or another \\u201cintermediate\\u201d value on the semantic hierarchy.
Caution is generally represented to users by styling the element with a yellow or
orange color.
Constant Value:
3
(0x00000003)
### SEMANTIC_STYLE_DANGER
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int SEMANTIC_STYLE_DANGER
```
This value is used to annotate an element as indicating danger, extreme urgency or
lateness, or another \\u201cextreme\\u201d value on the semantic hierarchy.
Danger is generally represented to users by styling the element with a red color.
Constant Value:
4
(0x00000004)
### SEMANTIC_STYLE_INFO
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int SEMANTIC_STYLE_INFO
```
This value is used to annotate an element as indicating information that should stand out
from other content, but which doesn\\u2019t fall on a scale or hierarchy. This can be thought of
as a more neutral value that may be used in cases where the element is intended to stand
out against elements with the other semantic styles -- for example if a `https://developer.android.com/reference/android/app/Notification.ProgressStyle`
bar uses semantic style to color segments, this style would be appropriate for segments where
the semantic hierarchy is unhelpful to the user.
Info is generally represented to users by styling the element with a color (like blue)
that is clearly distinct from the colors used for other styles.
Constant Value:
1
(0x00000001)
### SEMANTIC_STYLE_SAFE
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int SEMANTIC_STYLE_SAFE
```
This value is used to annotate an element as indicating safety, non-urgency, timeliness,
or another \\u201cmild\\u201d value on the semantic hierarchy.
Safety is generally represented to users by styling the element with a green color.
Constant Value:
2
(0x00000002)
### SEMANTIC_STYLE_UNSPECIFIED
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int SEMANTIC_STYLE_UNSPECIFIED
```
This is the default value for semantic style, signaling no particular semantics. An
`https://developer.android.com/reference/android/text/Annotation` with this style has no effect.
Constant Value:
0
(0x00000000)
### STREAM_DEFAULT
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int STREAM_DEFAULT
```
**This constant was deprecated
in API level 21.**
Use `https://developer.android.com/reference/android/app/NotificationChannel#getAudioAttributes()` instead.
Use this constant as the value for audioStreamType to request that
the default stream type for notifications be used. Currently the
default stream type is `https://developer.android.com/reference/android/media/AudioManager#STREAM_NOTIFICATION`.
Constant Value:
-1
(0xffffffff)
### VISIBILITY_PRIVATE
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int VISIBILITY_PRIVATE
```
Notification visibility: Show this notification on all lockscreens, but conceal sensitive or
private information on secure lockscreens. Conceal sensitive or private information while
screen sharing.
**See also:**
- `https://developer.android.com/reference/android/app/Notification#visibility`
Constant Value:
0
(0x00000000)
### VISIBILITY_PUBLIC
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int VISIBILITY_PUBLIC
```
Notification visibility: Show this notification in its entirety on all lockscreens and while
screen sharing.
**See also:**
- `https://developer.android.com/reference/android/app/Notification#visibility`
Constant Value:
1
(0x00000001)
### VISIBILITY_SECRET
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int VISIBILITY_SECRET
```
Notification visibility: Do not reveal any part of this notification on a secure lockscreen
or while screen sharing.
**See also:**
- `https://developer.android.com/reference/android/app/Notification#visibility`
Constant Value:
-1
(0xffffffff)
## Fields
### AUDIO_ATTRIBUTES_DEFAULT
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final AudioAttributes AUDIO_ATTRIBUTES_DEFAULT
```
The default value of `https://developer.android.com/reference/android/app/Notification#audioAttributes`.
### CREATOR
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final Creator CREATOR
```
Parcelable.Creator that instantiates Notification objects
### actions
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Action[] actions
```
Array of all `https://developer.android.com/reference/android/app/Notification.Action` structures attached to this notification by
`https://developer.android.com/reference/android/app/Notification.Builder#addAction(int,%20java.lang.CharSequence,%20android.app.PendingIntent)`. Mostly useful for instances of
`https://developer.android.com/reference/android/service/notification/NotificationListenerService` that provide an alternative
interface for invoking actions.
### audioAttributes
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AudioAttributes audioAttributes
```
**This field was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationChannel#getAudioAttributes()` instead.
The `https://developer.android.com/reference/android/media/AudioAttributes` to use when playing the sound.
### audioStreamType
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int audioStreamType
```
**This field was deprecated
in API level 21.**
Use `https://developer.android.com/reference/android/app/Notification#audioAttributes` instead.
The audio stream type to use when playing the sound.
Should be one of the STREAM_ constants from
`https://developer.android.com/reference/android/media/AudioManager`.
### bigContentView
Added in [API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public RemoteViews bigContentView
```
A large-format version of `https://developer.android.com/reference/android/app/Notification#contentView`, giving the Notification an
opportunity to show more detail when expanded. The system UI may choose
to show this instead of the normal content view at its discretion.
As of N, this field may be null. The expanded notification view is determined by the
inputs to `https://developer.android.com/reference/android/app/Notification.Builder`; a custom RemoteViews can optionally be
supplied with `https://developer.android.com/reference/android/app/Notification.Builder#setCustomBigContentView(android.widget.RemoteViews)`.
### category
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String category
```
One of the predefined notification categories (see the `CATEGORY_*` constants)
that best describes this Notification. May be used by the system for ranking and filtering.
### color
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int color
```
Accent color (an ARGB integer like the constants in `https://developer.android.com/reference/android/graphics/Color`)
to be applied by the standard Style templates when presenting this notification.
The current template design constructs a colorful header image by overlaying the
`https://developer.android.com/reference/android/app/Notification#icon` image (stenciled in white) atop a field of this color. Alpha components are
ignored.
### contentIntent
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public PendingIntent contentIntent
```
The intent to execute when the expanded status entry is clicked. If
this is an activity, it must include the
`https://developer.android.com/reference/android/content/Intent#FLAG_ACTIVITY_NEW_TASK` flag, which requires
that you take care of task management as described in the
[Tasks and Back
Stack](https://developer.android.com/guide/topics/fundamentals/tasks-and-back-stack) document. In particular, make sure to read the
[Start
an Activity from a Notification](https://developer.android.com/training/notify-user/navigation) page for the correct ways to launch an application from a
notification.
### contentView
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public RemoteViews contentView
```
The view that will represent this notification in the notification list (which is pulled
down from the status bar).
As of N, this field may be null. The notification view is determined by the inputs
to `https://developer.android.com/reference/android/app/Notification.Builder`; a custom RemoteViews can optionally be
supplied with `https://developer.android.com/reference/android/app/Notification.Builder#setCustomContentView(android.widget.RemoteViews)`.
### defaults
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int defaults
```
**This field was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationChannel#getSound()` and
`https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()` and
`https://developer.android.com/reference/android/app/NotificationChannel#shouldVibrate()`.
Specifies which values should be taken from the defaults.
To set, OR the desired from `https://developer.android.com/reference/android/app/Notification#DEFAULT_SOUND`,
`https://developer.android.com/reference/android/app/Notification#DEFAULT_VIBRATE`, `https://developer.android.com/reference/android/app/Notification#DEFAULT_LIGHTS`. For all default
values, use `https://developer.android.com/reference/android/app/Notification#DEFAULT_ALL`.
### deleteIntent
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public PendingIntent deleteIntent
```
The intent to execute when the notification is explicitly dismissed by the user, either with
the "Clear All" button or by swiping it away individually.
This probably shouldn't be launching an activity since several of those will be sent
at the same time.
### extras
Added in [API level 19](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Bundle extras
```
Additional semantic data to be carried around with this Notification.
The extras keys defined here are intended to capture the original inputs to `https://developer.android.com/reference/android/app/Notification.Builder`
APIs, and are intended to be used by
`https://developer.android.com/reference/android/service/notification/NotificationListenerService` implementations to extract
detailed information from notification objects.
### flags
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int flags
```
### fullScreenIntent
Added in [API level 9](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public PendingIntent fullScreenIntent
```
An intent to launch instead of posting the notification to the status bar.
The system UI may choose to display a heads-up notification, instead of
launching this intent, while the user is using the device.
**See also:**
- `https://developer.android.com/reference/android/app/Notification.Builder#setFullScreenIntent(android.app.PendingIntent,%20boolean)`
### headsUpContentView
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public RemoteViews headsUpContentView
```
A medium-format version of `https://developer.android.com/reference/android/app/Notification#contentView`, providing the Notification an
opportunity to add action buttons to contentView. At its discretion, the system UI may
choose to show this as a heads-up notification, which will pop up so the user can see
it without leaving their current activity.
As of N, this field may be null. The heads-up notification view is determined by the
inputs to `https://developer.android.com/reference/android/app/Notification.Builder`; a custom RemoteViews can optionally be
supplied with `https://developer.android.com/reference/android/app/Notification.Builder#setCustomHeadsUpContentView(android.widget.RemoteViews)`.
### icon
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int icon
```
**This field was deprecated
in API level 23.**
Use `https://developer.android.com/reference/android/app/Notification.Builder#setSmallIcon(android.graphics.drawable.Icon)` instead.
The resource id of a drawable to use as the icon in the status bar.
### iconLevel
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int iconLevel
```
If the icon in the status bar is to have more than one level, you can set this. Otherwise,
leave it at its default value of 0.
**See also:**
- `https://developer.android.com/reference/android/widget/ImageView#setImageLevel(int)`
- `https://developer.android.com/reference/android/graphics/drawable/Drawable#setLevel(int)`
### largeIcon
Added in [API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Bitmap largeIcon
```
**This field was deprecated
in API level 23.**
Use `https://developer.android.com/reference/android/app/Notification.Builder#setLargeIcon(android.graphics.drawable.Icon)` instead.
A large bitmap to be shown in the notification content area.
### ledARGB
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int ledARGB
```
**This field was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()`.
The color of the led. The hardware will do its best approximation.
**See also:**
- `https://developer.android.com/reference/android/app/Notification#FLAG_SHOW_LIGHTS`
- `https://developer.android.com/reference/android/app/Notification#flags`
### ledOffMS
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int ledOffMS
```
**This field was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()`.
The number of milliseconds for the LED to be off while it's flashing.
The hardware will do its best approximation.
**See also:**
- `https://developer.android.com/reference/android/app/Notification#FLAG_SHOW_LIGHTS`
- `https://developer.android.com/reference/android/app/Notification#flags`
### ledOnMS
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int ledOnMS
```
**This field was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationChannel#shouldShowLights()`.
The number of milliseconds for the LED to be on while it's flashing.
The hardware will do its best approximation.
**See also:**
- `https://developer.android.com/reference/android/app/Notification#FLAG_SHOW_LIGHTS`
- `https://developer.android.com/reference/android/app/Notification#flags`
### number
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int number
```
The number of events that this notification represents. For example, in a new mail
notification, this could be the number of unread messages.
The system may or may not use this field to modify the appearance of the notification.
Starting with `https://developer.android.com/reference/android/os/Build.VERSION_CODES#O`, the number may be displayed as a
badge icon in Launchers that support badging.
### priority
Added in [API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int priority
```
**This field was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationChannel#getImportance()` instead.
Relative priority for this notification.
Priority is an indication of how much of the user's valuable attention should be consumed
by this notification. Low-priority notifications may be hidden from the user in certain
situations, while the user might be interrupted for a higher-priority notification. The
system will make a determination about how to interpret this priority when presenting
the notification.
A notification that is at least `https://developer.android.com/reference/android/app/Notification#PRIORITY_HIGH` is more likely to be presented
as a heads-up notification.
.
Value is one of the following:
- `https://developer.android.com/reference/android/app/Notification#PRIORITY_DEFAULT`
- `https://developer.android.com/reference/android/app/Notification#PRIORITY_LOW`
- `https://developer.android.com/reference/android/app/Notification#PRIORITY_MIN`
- `https://developer.android.com/reference/android/app/Notification#PRIORITY_HIGH`
- `https://developer.android.com/reference/android/app/Notification#PRIORITY_MAX`
### publicVersion
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Notification publicVersion
```
Replacement version of this notification whose content will be shown
in an insecure context such as atop a secure keyguard. See `https://developer.android.com/reference/android/app/Notification#visibility`
and `https://developer.android.com/reference/android/app/Notification#VISIBILITY_PUBLIC`.
### sound
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Uri sound
```
**This field was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationChannel#getSound()`.
The sound to play.
A notification that is noisy is more likely to be presented as a heads-up notification.
To play the default notification sound, see `https://developer.android.com/reference/android/app/Notification#defaults`.
### tickerText
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public CharSequence tickerText
```
Text that summarizes this notification for accessibility services.
As of the L release, this text is no longer shown on screen, but it is still useful to
accessibility services (where it serves as an audible announcement of the notification's
appearance).
**See also:**
- `https://developer.android.com/reference/android/app/Notification#tickerView`
### tickerView
Added in [API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public RemoteViews tickerView
```
Formerly, a view showing the `https://developer.android.com/reference/android/app/Notification#tickerText`.
No longer displayed in the status bar as of API 21.
### vibrate
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public long[] vibrate
```
**This field was deprecated
in API level 26.**
use `https://developer.android.com/reference/android/app/NotificationChannel#getVibrationPattern()`.
The pattern with which to vibrate.
To vibrate the default pattern, see `https://developer.android.com/reference/android/app/Notification#defaults`.
**See also:**
- `https://developer.android.com/reference/android/os/Vibrator#vibrate(long[],%20int)`
### visibility
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int visibility
```
Sphere of visibility of this notification, which affects how and when the SystemUI reveals
the notification's presence and contents in untrusted situations (namely, on the secure
lockscreen and during screen sharing).
The default level, `https://developer.android.com/reference/android/app/Notification#VISIBILITY_PRIVATE`, behaves exactly as notifications have
always done on Android: The notification's `https://developer.android.com/reference/android/app/Notification#icon` and `https://developer.android.com/reference/android/app/Notification#tickerText` (if
available) are shown in all situations, but the contents are only available if the device is
unlocked for the appropriate user and there is no active screen sharing session.
A more permissive policy can be expressed by `https://developer.android.com/reference/android/app/Notification#VISIBILITY_PUBLIC`; such a
notification can be read even in an "insecure" context (that is, above a secure lockscreen or
while screen sharing with a remote viewer).
To modify the public version of this notification\\u2014for example, to redact some portions\\u2014see
`https://developer.android.com/reference/android/app/Notification.Builder#setPublicVersion(android.app.Notification)`.
Finally, a notification can be made `https://developer.android.com/reference/android/app/Notification#VISIBILITY_SECRET`, which will suppress its
icon and ticker until the user has bypassed the lockscreen.
Value is one of the following:
- `https://developer.android.com/reference/android/app/Notification#VISIBILITY_PUBLIC`
- `https://developer.android.com/reference/android/app/Notification#VISIBILITY_PRIVATE`
- `https://developer.android.com/reference/android/app/Notification#VISIBILITY_SECRET`
### when
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public long when
```
A timestamp related to this notification, in milliseconds since the epoch.
Default value: `https://developer.android.com/reference/java/lang/System#currentTimeMillis()`.
Choose a timestamp that will be most relevant to the user. For most finite events, this
corresponds to the time the event happened (or will happen, in the case of events that have
yet to occur but about which the user is being informed). Indefinite events should be
timestamped according to when the activity began.
Some examples:
- Notification of a new chat message should be stamped when the message was received.
- Notification of an ongoing file download (with a progress bar, for example) should be stamped when the download started.
- Notification of a completed file download should be stamped when the download finished.
- Notification of an upcoming meeting should be stamped with the time the meeting will begin (that is, in the future).
- Notification of an ongoing stopwatch (increasing timer) should be stamped with the watch's start time.
- Notification of an ongoing countdown timer should be stamped with the timer's end time.
For apps targeting `https://developer.android.com/reference/android/os/Build.VERSION_CODES#N` and above, this time is not
shown anymore by default and must be opted into by using
`https://developer.android.com/reference/android/app/Notification.Builder#setShowWhen(boolean)`
## Public constructors
### Notification
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Notification ()
```
Constructs a Notification object with default values.
You should use `https://developer.android.com/reference/android/app/Notification.Builder` instead.
### Notification
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Notification (Parcel parcel)
```
Unflatten the notification from a parcel.
| Parameters ||
|---|---|
| `parcel` | `Parcel`
|
### Notification
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Notification (int icon,
CharSequence tickerText,
long when)
```
**This constructor is deprecated.**
Use `https://developer.android.com/reference/android/app/Notification.Builder` instead.
Constructs a Notification object with the information needed to
have a status bar icon without the standard expanded view.
| Parameters ||
|---|---|
| `icon` | `int`: the resource id of the icon to put in the status bar
|
| `tickerText` | `CharSequence`: the text that flows by in the status bar when the notification first activates
|
| `when` | `long`: the time to show in the time field, in the `System.currentTimeMillis` timebase
|
## Public methods
### clone
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Notification clone ()
```
Creates and returns a copy of this object. The precise meaning
of "copy" may depend on the class of the object. The general
intent is that, for any object `x`, the expression:
>
> ```
> x.clone() != x
> ```
will be true, and that the expression:
>
> ```
> x.clone().getClass() == x.getClass()
> ```
will be `true`, but these are not absolute requirements. While it is typically the case that:
>
> ```
> x.clone().equals(x)
> ```
will be `true`, this is not an absolute requirement.
By convention, the returned object should be obtained by calling
`super.clone`. If a class and all of its superclasses (except
`Object`) obey this convention, it will be the case that
`x.clone().getClass() == x.getClass()`.
By convention, the object returned by this method should be independent
of this object (which is being cloned). To achieve this independence,
it may be necessary to modify one or more fields of the object returned
by `super.clone` before returning it. Typically, this means
copying any mutable objects that comprise the internal "deep structure"
of the object being cloned and replacing the references to these
objects with references to the copies. If a class contains only
primitive fields or references to immutable objects, then it is usually
the case that no fields in the object returned by `super.clone`
need to be modified.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification` | a clone of this instance.
|
### createSemanticStyleAnnotation
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static Annotation createSemanticStyleAnnotation (int semanticStyle)
```
Constructs an `https://developer.android.com/reference/android/text/Annotation` that can be used to span text in a `https://developer.android.com/reference/android/text/Spanned`
`https://developer.android.com/reference/java/lang/CharSequence` in some Notification text fields, and which may then be converted into
styling of that section of text in order to indicate the semantic style. Since Notifications
may strip styling, even for semantic styles, it\\u2019s important that stripping these styles
should not distort the meaning of the text.
Semantic style will only be applied to text appearance in notifications that are eligible
(e.g. `https://developer.android.com/reference/android/app/Notification#FLAG_PROMOTED_ONGOING` notifications).
| Parameters ||
|---|---|
| `semanticStyle` | `int`: Value is one of the following: - `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_UNSPECIFIED` - `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_INFO` - `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_SAFE` - `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_CAUTION` - `https://developer.android.com/reference/android/app/Notification#SEMANTIC_STYLE_DANGER` |
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/text/Annotation` | This value cannot be `null`.
|
**See also:**
- `https://developer.android.com/reference/android/text/Spannable#setSpan(java.lang.Object,%20int,%20int,%20int)`
### describeContents
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int describeContents ()
```
Describe the kinds of special objects contained in this Parcelable
instance's marshaled representation. For example, if the object will
include a file descriptor in the output of `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`,
the return value of this method must include the
`https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` bit.
| Returns ||
|---|---|
| `int` | a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either `0` or - `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` |
### findRemoteInputActionPair
Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Pair findRemoteInputActionPair (boolean requiresFreeform)
```
Finds and returns a remote input and its corresponding action.
| Parameters ||
|---|---|
| `requiresFreeform` | `boolean`: requires the remoteinput to allow freeform or not
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/util/Pair` | the result pair, `null` if no result is found
|
### getAllowSystemGeneratedContextualActions
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean getAllowSystemGeneratedContextualActions ()
```
Returns whether the platform is allowed (by the app developer) to generate contextual actions
for this notification.
| Returns ||
|---|---|
| `boolean` |
|
### getBadgeIconType
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getBadgeIconType ()
```
Returns what icon should be shown for this notification if it is being displayed in a
Launcher that supports badging. Will be one of `https://developer.android.com/reference/android/app/Notification#BADGE_ICON_NONE`,
`https://developer.android.com/reference/android/app/Notification#BADGE_ICON_SMALL`, or `https://developer.android.com/reference/android/app/Notification#BADGE_ICON_LARGE`.
| Returns ||
|---|---|
| `int` |
|
### getBridgedNotificationMetadata
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Notification.BridgedNotificationMetadata getBridgedNotificationMetadata ()
```
Returns the metadata associated with a notification originating on another device.
A copy of the original notification is sent to this device by a bridging app. This
metadata is used for displaying the notification as a bridged notification to the user.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BridgedNotificationMetadata` | the metadata associated with the notification. This value may be `null`.
|
### getBubbleMetadata
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Notification.BubbleMetadata getBubbleMetadata ()
```
Returns the bubble metadata that will be used to display app content in a floating window
over the existing foreground activity.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BubbleMetadata` | This value may be `null`.
|
### getChannelId
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getChannelId ()
```
Returns the id of the channel this notification posts to.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` |
|
### getContextualActions
Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public List getContextualActions ()
```
Returns the actions that are contextual (that is, suggested because of the content of the
notification) out of the actions in this notification.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/List` | This value cannot be `null`.
|
### getGroup
Added in [API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getGroup ()
```
Get the key used to group this notification into a cluster or stack
with other notifications on devices which support such rendering.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` |
|
### getGroupAlertBehavior
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getGroupAlertBehavior ()
```
Returns which type of notifications in a group are responsible for audibly alerting the
user.
| Returns ||
|---|---|
| `int` | Value is one of the following: - `https://developer.android.com/reference/android/app/Notification#GROUP_ALERT_ALL` - `https://developer.android.com/reference/android/app/Notification#GROUP_ALERT_CHILDREN` - `https://developer.android.com/reference/android/app/Notification#GROUP_ALERT_SUMMARY` |
### getLargeIcon
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Icon getLargeIcon ()
```
The large icon shown in this notification's content view.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/graphics/drawable/Icon` |
|
**See also:**
- `https://developer.android.com/reference/android/app/Notification#getLargeIcon()`
- `https://developer.android.com/reference/android/app/Notification.Builder#setLargeIcon(android.graphics.drawable.Icon)`
### getLocusId
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public LocusId getLocusId ()
```
Gets the `https://developer.android.com/reference/android/content/LocusId` associated with this notification.
Used by the device's intelligence services to correlate objects (such as
`https://developer.android.com/reference/android/content/pm/ShortcutInfo` and `https://developer.android.com/reference/android/view/contentcapture/ContentCaptureContext`) that are correlated.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/content/LocusId` | This value may be `null`.
|
### getSettingsText
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public CharSequence getSettingsText ()
```
Returns the settings text provided to `https://developer.android.com/reference/android/app/Notification.Builder#setSettingsText(java.lang.CharSequence)`.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/CharSequence` |
|
### getShortCriticalText
Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getShortCriticalText ()
```
Returns the very short text summarizing the most critical information contained in the
notification, or `null` if this field was not set.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` |
|
### getShortcutId
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getShortcutId ()
```
Returns the `https://developer.android.com/reference/android/content/pm/ShortcutInfo#getId()` that this notification supersedes, if any.
Used by some Launchers that display notification content to hide shortcuts that duplicate
notifications.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` |
|
### getSmallIcon
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Icon getSmallIcon ()
```
The small icon representing this notification in the status bar.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/graphics/drawable/Icon` | the small icon representing this notification
|
**See also:**
- `https://developer.android.com/reference/android/app/Notification#getSmallIcon()`
- `https://developer.android.com/reference/android/app/Notification.Builder#setSmallIcon(android.graphics.drawable.Icon)`
### getSortKey
Added in [API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getSortKey ()
```
Get a sort key that orders this notification among other notifications from the
same package. This can be useful if an external sort was already applied and an app
would like to preserve this. Notifications will be sorted lexicographically using this
value, although providing different priorities in addition to providing sort key may
cause this value to be ignored.
This sort key can also be used to order members of a notification group. See
`https://developer.android.com/reference/android/app/Notification.Builder#setGroup(java.lang.String)`.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` |
|
**See also:**
- `https://developer.android.com/reference/java/lang/String#compareTo(java.lang.String)`
### getTimeoutAfter
Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public long getTimeoutAfter ()
```
Returns the duration from posting after which this notification should be canceled by the
system, if it's not canceled already.
| Returns ||
|---|---|
| `long` |
|
### hasImage
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean hasImage ()
```
| Returns ||
|---|---|
| `boolean` | `true` if the notification has an image
|
### hasPromotableCharacteristics
Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean hasPromotableCharacteristics ()
```
Returns whether the notification has all the characteristics that make it eligible for
`https://developer.android.com/reference/android/app/Notification#FLAG_PROMOTED_ONGOING`. This method does not factor in other criteria such user
preferences for the app or channel. If this returns `true`, it does not guarantee that
the notification will be assigned `https://developer.android.com/reference/android/app/Notification#FLAG_PROMOTED_ONGOING` by the system, but if this
returns `false`, it will not.
| Returns ||
|---|---|
| `boolean` |
|
### hasSummarizedContent
Added in [version 36.1](https://developer.android.com/topic/libraries/support-library/revisions)
```
public boolean hasSummarizedContent ()
```
Returns whether this notification contains computationally summarized text. The
OS may choose to display this content instead of the original notification content on
some surfaces and may add styling to indicate to the user that this was computationally
generated.
| Returns ||
|---|---|
| `boolean` |
|
### isRequestPromotedOngoing
Added in [version 36.1](https://developer.android.com/topic/libraries/support-library/revisions)
```
public boolean isRequestPromotedOngoing ()
```
Returns whether this notification has requested to be a promoted ongoing notification.
| Returns ||
|---|---|
| `boolean` |
|
**See also:**
- `https://developer.android.com/reference/android/app/Notification#EXTRA_REQUEST_PROMOTED_ONGOING`
- `https://developer.android.com/reference/android/app/Notification.Builder#setRequestPromotedOngoing(boolean)`
### toString
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String toString ()
```
Returns a string representation of the object.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | a string representation of the object.
|
### writeToParcel
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void writeToParcel (Parcel parcel,
int flags)
```
Flatten this notification into a parcel.
| Parameters ||
|---|---|
| `parcel` | `Parcel`: The Parcel in which the object should be written. This value cannot be `null`.
|
| `flags` | `int`: Additional flags about how the object should be written. May be 0 or `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE`. Value is either `0` or a combination of the following: - `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE` |