Web Push notifications in Firefox

Revision Information
  • Revision id: 115565
  • Created:
  • Creator: AliceWyman
  • Comment: added Content panel image for winxp,linux,mac
  • Reviewed: Yes
  • Reviewed:
  • Reviewed by: ideato
  • Is approved? Yes
  • Is current revision? No
  • Ready for localization: Yes
  • Readied for localization:
  • Readied for localization by: ideato
Revision Source
Revision Content

Web Push allows websites to notify users of new messages or updated content. While Firefox is open, websites who have been granted permissions, can send notifications to your browser and display notifications on the screen. Users can easily allow or disable notifications and control how these notifications appear.

Upgraded Notifications

Starting with version 44, Firefox can deliver on-screen notifications even when that site isn’t loaded. Using the Push API, a W3C standard, Firefox receives a push message and can show notifications (if permitted by the user) at any time. Sites can also use Push to update data in the background even without showing you a notification. If you already gave permission to a site to send notifications, these sites will also be able to use the Push API. You can choose whether or not to give permission for a site to send you notifications by following these instructions:

  1. Go to the Firefox menu New Fx Menu and select OptionsPreferences.
  2. Select the Content panel and click the Choose button under Notifications.
    push content panel 44push content panel 44 winxp
  3. Alternatively, click the options in one of the notifications you receive.
    push notification menu

What is Web Push?

Web Push is an optional feature that allows websites to send you messages even when the site isn’t loaded. Sites can use this feature to provide you with notifications or update data in the background.

For instance, you can subscribe to notifications from your favorite shopping websites which can notify you of new promotions or offers. You can subscribe to notifications from different websites. A concert site may offer you notifications for shows of your favorite band; you allow that site to notify you, and a week later you get a notification that your band is on tour.

You will only receive messages from sites for which you have granted permission.

How does it work?

Websites can install a Service Worker, a background web page with a limited set of functionality, that can subscribe to the push service. The website can then send a push message through Mozilla’s Web Push service to your browser, which can process that message and display a notification on your screen.

push notification 44

Clicking the notification can open a website or switch to that site’s tab if loaded.

What information do I share with a website?

A website that has been granted permissions can send you push messages when the site isn’t loaded. A quota limits the number of push messages without an on-screen notification that sites can send you. Websites that exceed the quota will have its push messaging disabled and the user must revisit the website again to resubscribe. Web Push does not directly allow websites to determine your IP address.

What information does Firefox use to provide Web Push?

Firefox maintains an active connection to a push service in order to receive push messages as long as it is open. The connection ends when Firefox is closed. On our server we store a randomized identifier for your browser, along with a randomized identifier for each site you authorize.

On Firefox for desktop, the push service is operated by Mozilla. Firefox for Android uses a combination of the Mozilla Web Push service and Google’s Cloud Messaging platform to deliver notifications to Firefox for Android.

In both cases, push messages are encrypted per the IETF spec and only your copy of Firefox can decipher them. The encrypted messages are stored on the server until they are delivered or expire.

How do I revoke Web Push permissions?

Web Push is always opt-in in Firefox. A site cannot send you push messages without your permission. To stop a specific site from sending you push messages:

  1. Go to the Firefox menu New Fx Menu and select OptionsPreferences.
  2. Select the Content panel and click the Choose button under Notifications.
  3. Select the site.
  4. Click Remove Site.

To stop all sites from sending you push messages, follow the above steps except, instead of selecting a specific site, click Remove All Sites. Websites will not be able to send you messages and will need to ask your permission to send them in the future.

How do I add Web Push to my website?

The Push API specification explains how to create a Service Worker and send push messages.