Skip to Content
Platform.Ontology

Declarative Web Push (Safari)

A push format that shows a notification without running site code.

Works without askingNotifications and backgroundPushWeb browsersAfter you leave the site

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

BrowserStatusFirst versionReleasedNote
ChromeNot supportedDifferent proposalNot listedNone
EdgeNot supportedNot availableNot listedNone
FirefoxNot supportedDifferent proposalNot listedNone
SafariSupported162022-09-12macOS 15.5 Safari (beta)
Safari on iPhoneSupported16.42023-03-27iPadOS 18.4
Chrome on AndroidNot supportedNot availableNot listedNone
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APIpushManager.subscribe via window; payload {"web_push": 8030, "notification": {title, navigate, body, lang, dir, silent, app_badge}}
Permission namepush
Browser compat keysapi.PushManager
How access is grantedprompt
What the user seesSame 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 gestureYes
How long it lastsSame as Web Push subscription
How to take it backSame as notifications
Inside an iframeSame

Typical flow

  1. Subscribe from the page
  2. Send JSON with web_push 8030 and a notification object
  3. Safari shows the notification itself
  4. Tap opens the navigate URL

Data you get

What comes back: Notification JSON handled by the browser
Shape: object
How often: any time

FieldTypeUnitRangePrecision
web_pushintegermagicmust be 8030fixed
titlestringtextrequiredany
navigatestringURLrequiredabsolute URL
body, lang, dir, silent, app_badgemixednoneoptionalper 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

TypeExampleApps
newsA news site sends a headline, picture and link in the set format, and Safari shows it with no site code.None named
messagingA web chat sends a short message notice. Safari shows the sender and text, and the tap opens the thread.None named
shoppingA store sends a shipping update as a ready made notice.None named
liveA sports site sends a score alert with a link to the live page.None named
gamesA browser game sends a turn ready alert without a heavy background script.None named
socialA social site sends new follower notices that open the profile on tap.None named
securityA 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

ScoreValueMeaning
Sensitivity4 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough 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

Sources

How well checked: Checked against real behavior.

On this page