Chrome Dev Summit is back! Visit to secure your spot in workshops, office hours and learning lounges!

Moving to the Native Notification System on macOS

Starting in Chrome 59, notifications sent via the Notifications API or the chrome.notifications extensions API will be shown directly by the macOS native notification system instead of Chrome's own system.

This change makes Chrome on macOS feel much better integrated into the platform and fixes a number of long standing bugs, such as Chrome not respecting the system Do Not Disturb setting.

Below we'll look at the differences this change introduces to the existing API's.

Notification center

One of the benefits of this change is that notifications will be displayed in macOS’s notification center.

Google Chrome Notifications will be displayed in the macOS notification center


Icon size and positioning

The appearance of icons will change. They'll be smaller in size and padding is applied. You may want to consider switching to a transparent background icon instead of a solid color to be aesthetically pleasing.

Before and after for Chrome on Mac notification icons displayed by Chrome vs. displayed by macOS

Action icons

Before this change action buttons and icons would be displayed in the notification. With native notifications the action button icons will not be used and the user will need to hover over the notification and select the "More" button to see the available actions.

Before and after of notification action buttons with icons displayed by Chrome vs. displayed by macOS

The Chrome logo will always be displayed and cannot be replaced or altered. This is a requirement for third-party applications on macOS.


The image option will no longer be supported on macOS. If you define an image property the notification will still be displayed, but it will ignore the image parameter (See example below).

Before and after of notification image for Chrome on macOS

You can feature detect image support with the following code:

if ('image' in Notification.prototype) {  
  // Image is supported.
} else {  
  // Image is NOT supported.

Chrome extension changes

Chrome extensions have the concept of notification templates which will behave differently with this change.

The image notification template will no longer show the image. You should ensure that images are supplemental and not required to be useful to your users.

Before and after for image templates in the chrome.notification API

The list notification template will only show the first item in the list. You may want to consider moving back to the basic notification style and using body text to summarize the set of changes.

Before and after for list templates in the chrome.notification API

Progress notifications will append a percentage value to the notification title to indicate the progress instead of a progress bar.

Before and after for progress templates in the chrome.notification API

The last difference in notification UI is that the appIconMarkUrl will no longer be used on macOS.

Before and after for appIconMarkUrl in the chrome.notification API