Notifications
Asks to show system notifications outside the browser tab.
In one line
Can show messages on your screen outside the browser tab, once you tap Allow
Asks to show system notifications outside the browser tab.
Lets a site put messages on the person's desktop or lock screen. Reaches the person after they leave the page; abuse is spam, scams and fake alerts, so browsers add quiet prompts and auto-revocation.
What it can and can't do
What the user does: You tap Allow on the site's notification pop up
It can
- Show alerts on your desktop or lock screen after you leave the page
- Send chat, delivery or calendar updates you asked for
- Keep sending until you block it in site settings
It cannot
- Show anything before you tap Allow
- Keep showing alerts if you block the site or the browser auto removes it
- Use a loud pop up if Chrome decides to show a quiet icon instead
- Ask on iPhone unless the site is installed to the Home Screen
How it differs between platforms: Chrome and Firefox ask in the browser. On iPhone, the site must be installed to the Home Screen. Chrome may show a quiet chip for sites people rarely allow.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 20 | 2012-06-26 | Persistent notifications from 42 |
| Edge | Supported | 14 | 2016-08-02 | None |
| Firefox | Supported | 22 | 2013-06-25 | None |
| Safari | Supported | 7 | 2013-10-22 | Desktop Safari, page notifications from 7 |
| Safari on iPhone | Supported | 16.4 | 2023-03-27 | Home Screen web apps only, requires iOS 16.4 |
| Chrome on Android | Supported | 42 | 2015-04-15 | Constructor throws on Android, use showNotification |
| Samsung Internet | Supported | 4.0 | 2016-03-11 | None |
How a site asks for it
| API | Notification.requestPermission(); new Notification(title, options); ServiceWorkerRegistration.showNotification(); notificationclick |
| Permission name | notifications |
| Browser compat keys | api.Notificationapi.Notification.requestPermissionapi.ServiceWorkerRegistration.showNotification |
| How access is granted | prompt |
| What the user sees | Chrome: bubble with Allow or Block, or a quiet address-bar chip (Notifications blocked) from Chrome 80 for sites people rarely allow. Firefox: Allow or Not now plus Always block, needs a gesture since 72. Safari: system sheet, needs a gesture. |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Persistent per origin; Chrome auto-revokes unused or abusive sites and tells the person; Safari ties to the Notification Center |
| How to take it back | Padlock, Site settings, OS notification settings, Safety Hub one-tap unsubscribe on Android; Permissions API 'change' event. |
| Inside an iframe | Cross-origin iframes cannot request it; the requesting document must be top-level or same-origin with a gesture |
Typical flow
- Call Notification.requestPermission() from a click (required in Firefox and Safari)
- Browser shows prompt or quiet chip
- Permission becomes granted, denied or stays default
- Show with showNotification() or new Notification()
Data you get
What comes back: Notification display with title, body, icon, actions
Shape: object
How often: on demand, no rate limit besides OS
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
title | string | text | any | OS truncates about 50 to 100 characters |
body | string | text | any | OS truncates about 100 to 400 characters |
actions | list | buttons | up to Notification.maxActions (2 in Chrome desktop, 3 Android) | per platform |
icon, image, badge | string | URLs | images fetched on show | platform scaled |
requireInteraction | boolean | none | true or false | desktop Chrome only |
silent | boolean | none | true or false | suppress sound |
tag, renotify | string and boolean | none | replace earlier notification with same tag | one visible per tag |
Technical limits
- No notification display when the OS denies Do Not Disturb or the browser is closed (service worker needed for push)
- Cannot read other apps' notifications
- Cannot request without gesture on Firefox and Safari
- iOS only for installed Home Screen web apps
The story
What it is
A site asks to show pop up alerts on your device, even when you are not on the page.
For you
A prompt asks if the site can send you notifications. If you allow, alerts appear on screen like app alerts. You can turn them off later in site settings.
For makers
Makers use alerts to bring people back for news, messages, deals and live events. They are one of the strongest tools for return visits. Abuse is common, so browsers now quiet the prompts.
Where you see it
| Type | Example | Apps |
|---|---|---|
| news | A news site asks to alert you about breaking stories, which can pull you back several times a day. | BBC News |
| messaging | A web chat shows a pop up when a friend replies while you are in another tab. | WhatsApp Web, Slack |
| games | A browser game says your build has finished or a friend joined your game lobby. | None named |
| shopping | A store alerts you about a price drop on a saved item or a delivery update. | Amazon |
| live | A sports site sends goal alerts during a live match. | ESPN |
| productivity | A calendar or task site alerts you before a meeting or due date. | Google Calendar |
| ads | Some sites use alerts as an ad channel, sending promotions for a fee from advertisers. | None named |
| security | A bank sends a sign in alert when a new device logs in. | None named |
Risks
- Spam alerts
- Fake alert scams
What the platform says
- Google Chrome: Notification permission changes. Chrome moves unwanted notification requests to a quiet prompt, so pages ask less and you see fewer spam alerts.
Good uses and abuse
Legitimate uses
- Chat and email alerts
- Order and delivery updates
- Calendar reminders
Known abuse
- Scam and fake virus alerts
- Spam re-engagement
- Phishing impersonation of system dialogs
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 4 of 5 | How revealing the data is |
| Utility | 5 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2020-01, Firefox 72: Prompt requires a user gesture and shows quiet UI
- 2020-02, Chrome 80: Quieter notification UI for low-allow sites and abusive prompts
- 2022-09, Safari 16: Web Push and notifications on macOS 13 (Safari 16.1 in Ventura)
- 2023-03, Safari on iPhone 16.4: Notifications for Home Screen web apps
- 2025, Chrome: Auto-revocation of notification permission for unengaged and suspicious sites rolls out (exact version unconfirmed)
- 2026, Chrome: Chrome describes FCM throttling of disruptive domains at 1,000 messages per minute (exact version unconfirmed)
Related capabilities
Related
- Push API (Web Push). Can send you notifications after you leave, once you allow them
- Chrome and OS defenses against notification abuse. Can't keep sending spam if you block it; Chrome quiets and removes abusers
- Badging API. Can show a number or dot on the icon of an installed web app
Sources
How well checked: Based on official documentation.