Web Push notifications in Firefox

Revision Information
  • Revision id: 194318
  • Created:
  • Creator: AliceWyman
  • Comment: minor edit
  • Reviewed: Yes
  • Reviewed:
  • Reviewed by: AliceWyman
  • Is approved? Yes
  • Is current revision? No
  • Ready for localization: No
Revision Source
Revision Content

Web Push allows websites to notify you of new messages or updated content. While Firefox is open, websites which have been granted permission can send notifications to your browser, which displays them on the screen. Notifications only display when you press a key on your keyboard or tap/click anywhere on the website that you are accessing. If you have not interacted with the website, then the Notification permission Notifications icon icon will only display in the address bar; the actual notification will not display. You can easily allow or disable notifications and control how they appear.

Fx56AllowNotificationsFx70AllowNotifications

Upgraded Notifications

Firefox can deliver on-screen notifications even when that site is not 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, the site will also be able to use the Push API. You can choose whether or not to give permission for a specific website by following these instructions:

  1. Click the Site Information Site Info button icon in the address bar to bring up the Control Center panel.
  2. Click the arrow in the panel.
  3. Click More information in the next panel to bring up the Page Info window.
  4. Click the Permissions tab.
  5. Under Receive NotificationsSend Notifications, choose a notification option: Always Ask, Allow, or Block. If your choices are grayed out, deselect the Use Default checkbox.
  1. Click the padlock Gray padlock - Firefox 70 in the address bar.
  2. Click the arrow in the Site Information drop-down panel.
  3. Click More information in the next panel to bring up the Page Info window.
  4. Click the Permissions tab.
  5. Under Receive NotificationsSend Notifications, choose a notification option: Always Ask, Allow, or Block. If your choices are grayed out, deselect the Use Default checkbox.

Alternatively, you can:

  1. In the Menu bar at the top of the screen, click Firefox and then select Preferences or Settings, depending on your macOS version.Click the menu button Fx89menuButton and select Settings.
  2. Click Privacy & Security from the left pane.
  3. Scroll to the Permissions section.
  4. Click the Settings... button to the right of Notifications.
  5. Select Allow or Block from the Status drop-down for any of the websites.
  6. Click the Save Changes button.

What is Web Push?

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

For example, you can subscribe to notifications from your favorite shopping websites that 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 decide to 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 that 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 is not loaded. A quota limits the number of push messages without an on-screen notification that websites 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. We store a randomized identifier on our server for your browser along with a randomized identifier for each website that 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 for a specific site?

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. In the Menu bar at the top of the screen, click Firefox and then select Preferences or Settings, depending on your macOS version.Click the menu button Fx89menuButton and select Settings.
  2. Click Privacy & Security from the left pane.
  3. Scroll to the Permissions section.
  4. Click the Settings… button next to Notifications.
  5. Select the website.
  6. Click the Remove Website button.

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

To stop notifications on a specific webpage (requires a page reload): Click the Site Information Site Info button icon to bring up the Control Centerpadlock Gray padlock - Firefox 70 to bring up the Site Information panel for the website, find the Receive NotificationsSend Notifications permission and click the x next to Allowed to remove the permission.

How do I add Web Push to my website?

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

How do I stop Firefox asking me to allow notifications?

If a site indicates to Firefox that it wants to show notifications, by default, Firefox asks whether you want to grant permission. You can set Firefox to automatically deny permission without asking. Even after the change, you can make exceptions for sites you want to show notifications or use push features.

  1. In the Menu bar at the top of the screen, click Firefox and then select Preferences or Settings, depending on your macOS version.Click the menu button Fx89menuButton and select Settings.
  2. Click Privacy & Security from the left pane.
  3. Scroll to the Permissions section.
  4. Click the Settings… button to the right of Notifications.
    Fx59Permissions-NotificationSettings
  5. Select the Block new requests asking to allow notifications checkbox.
  6. Click the Save Changes button.