Create a progress-centric notification

top shade progress centric notification
Figure 1. A progress centric notification at the top of the shade.

Android 16 introduces a new notification template to help users seamlessly track user initiated start-to-end journeys. These notifications will have upgraded visibility on system surfaces and top ranking in the notification drawer.

Use Notification.ProgressStyle to stylize progress centric notifications. Key use cases include rideshare, delivery, and navigation. Within that class, you will find the ability to denote states and milestones in a user journey using Points and Segments.

Relevant classes

The following classes contain the different APIs that you use to construct a ProgressStyle notification:

Anatomy and customization

The following images show the different parts that make up ProgressStyle notifications:

Figure 2.

A. Header - Subtext

Notification.Builder#setSubText()

B. Header - Time

Notification.Builder#setWhen()

C. Content Title

Notification.Builder#setContentTitle()

D. Content Text

Notification.Builder#setContentText()

E. Progress bar

Notification.ProgressStyle

F. Action button

Notification.Builder#addAction()
Figure 3. Apps can set a vehicle image for the tracker icon and use segments and points to denote the rideshare experience and milestones.

Set up

Use the right APIs and follow best practices to provide the best user experience for progress updates.

  • Set the right fields to meet promoted visibility.
  • Use the right visual elements to guide users. For example, rideshare apps should set a vehicle image and use the most accurate color of the vehicle in the notification using Notification#setLargeIcon.
  • Use concise and clear language to define the progress of the user journey. Time of arrival, driver name, and state of the journey are important text that the notification should communicate.
  • Provide useful and relevant actions in the notification that streamline the user journey. For example, providing "Tip" and "Add dish" to a newly initiated food delivery order are useful actions before delivery.
  • Use segments and points to denote states. For example, segments can colorize the state and duration of traffic in a rideshare journey. Points represent states for milestones such as food preparation, delivery, and passenger pickup.
  • Update the progress experience to accurately reflect the actual progression of the journey. For example, changes in traffic conditions can be reflected in changes in segment colors and updates in text.

The following example shows a ProgressStyle notification for a rideshare app.

The example shows the use of a vehicle image for the tracker icon, and the use of segments and points to denote the rideshare experience and milestones.

See the sample app to experiment with these APIs.