Declarative Web Push (Safari)
A push format that shows a notification without running site code.
In one line
Can show you a notification from Safari's new push format without running site code
A push format that shows a notification without running site code.
The browser renders the notification straight from JSON, so no service worker runs. Cuts battery use and removes the old silent-push abuse path; the site still learns when a device is online.
What it can and can't do
What the user does: You tap Allow on the notification pop up in Safari
It can
- Show a notification straight from the message, with no site script running
- Save battery compared with older push
- Learn when your device is online, as with classic push
It cannot
- Send anything before you tap Allow
- Run hidden code in the background to do something else
- Work in Chrome, Edge, Firefox or Samsung Internet
- Reach iPhone unless the site is a Home Screen web app
How it differs between platforms: Only Safari on Mac and iPhone supports this format. Other browsers use the classic push format.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Not supported | Different proposal | Not listed | None |
| Edge | Not supported | Not available | Not listed | None |
| Firefox | Not supported | Different proposal | Not listed | None |
| Safari | Supported | 16 | 2022-09-12 | macOS 15.5 Safari (beta) |
| Safari on iPhone | Supported | 16.4 | 2023-03-27 | iPadOS 18.4 |
| Chrome on Android | Not supported | Not available | Not listed | None |
| Samsung Internet | Not supported | Not available | Not listed | None |
How a site asks for it
| API | pushManager.subscribe via window; payload {"web_push": 8030, "notification": {title, navigate, body, lang, dir, silent, app_badge}} |
| Permission name | push |
| Browser compat keys | api.PushManager |
| How access is granted | prompt |
| What the user sees | Same system notification prompt as classic Web Push; subscription made from the window with no service worker. |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Same as Web Push subscription |
| How to take it back | Same as notifications |
| Inside an iframe | Same |
Typical flow
- Subscribe from the page
- Send JSON with web_push 8030 and a notification object
- Safari shows the notification itself
- Tap opens the navigate URL
Data you get
What comes back: Notification JSON handled by the browser
Shape: object
How often: any time
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
web_push | integer | magic | must be 8030 | fixed |
title | string | text | required | any |
navigate | string | URL | required | absolute URL |
body, lang, dir, silent, app_badge | mixed | none | optional | per field |
Technical limits
- Always shows a visible notification (no silent push)
- Optional service worker can still adjust the message
- Safari only
The story
What it is
A push format that shows a notification without running the site's code first.
For you
You tap Allow once and notifications show up as usual. Under the hood the browser shows them without waking the site. This saves battery and reduces what the site learns.
For makers
Makers send a ready made message in a set format. It is simpler to build, more reliable and cheaper to run, but gives less control to run code on arrival. It suits news, chat and alerts.
Where you see it
| Type | Example | Apps |
|---|---|---|
| news | A news site sends a headline, picture and link in the set format, and Safari shows it with no site code. | None named |
| messaging | A web chat sends a short message notice. Safari shows the sender and text, and the tap opens the thread. | None named |
| shopping | A store sends a shipping update as a ready made notice. | None named |
| live | A sports site sends a score alert with a link to the live page. | None named |
| games | A browser game sends a turn ready alert without a heavy background script. | None named |
| social | A social site sends new follower notices that open the profile on tap. | None named |
| security | A bank sends a sign in notice that shows safely with no site script involved. | None named |
Risks
- Less control for makers
- Safari only
What the platform says
- WebKit: Declarative Web Push. A simpler push format where the browser shows the notice itself, with no background script, for better privacy and battery.
Good uses and abuse
Legitimate uses
- Reliable low battery notifications
Known abuse
- Same as classic push
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 4 of 5 | How revealing the data is |
| Utility | 4 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
- 2025-03, Safari on iPhone 18.4: Declarative Web Push ships in iOS and iPadOS 18.4
- 2025-05, Safari 18.5: macOS 15.5 Safari beta adds it
Related capabilities
Related
- Push API (Web Push). Can send you notifications after you leave, once you allow them
Sources
How well checked: Checked against real behavior.