Web push notifications
Web push notifications is described on the screen as: “Let visitors opt in to browser
notifications and send them new posts and offers.” It is at /marketing/web-push and needs the
settings.manage permission to open.
Settings
Section titled “Settings”The Settings card begins: “Off until you turn it on. Visitors are never asked on their first page view: a small prompt appears only after they answered the cookie banner and stayed a while, and the browser asks only after they click Allow. Never on checkout, cart or account pages.”
| Field | What the screen says |
|---|---|
| Enable web push | “Turning this on for the first time creates your store’s push keys.” |
| Prompt delay (seconds) | “How long a visitor stays before the prompt may appear.” |
| Send rate (per minute) | “Upper limit of notifications sent per minute while a campaign goes out.” |
| Prompt title and Prompt text | The wording of the small prompt shown to visitors. |
| Contact for push services (optional) | “A mailto: address or https:// URL the browser push services can reach. Leave empty to use the platform’s.” |
| Public key | Displayed for reference. |
Subscribers
Section titled “Subscribers”Subscribers counts “Browsers that allowed notifications from this site, by language”, with an “unknown language” group for browsers that did not report one.
New notification
Section titled “New notification”The New notification form is available once web push is on; until then it says “Turn web push
on above to send notifications.” Its fields are Title, Message, Link (a page on this
site such as /blog/post, or an https address), Image (optional), Audience (Everyone
or one language, each with its subscriber count), Send at (optional) and Campaign name
(optional). Leaving Send at empty sends now; the buttons are Send now and Schedule.
After Send now the screen says “Notification queued — it goes out within a minute.” (text read 2026-11-11).
The form notes that clicks carry utm_source=web_push, utm_medium=push and the campaign name
“so analytics attributes them.” The campaign name is used as utm_campaign and is generated from
the title when left empty.
Sent and scheduled
Section titled “Sent and scheduled”The table lists each notification with Status (Scheduled, Sending, Sent, Canceled or Failed), Sent, Expired, Clicks and CTR. The screen defines the columns: “Sent = accepted by the browser push service. Expired = the browser unsubscribed (removed automatically). CTR = clicks / sent.” A scheduled notification has a Cancel action.