Skip to content

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.

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 counts “Browsers that allowed notifications from this site, by language”, with an “unknown language” group for browsers that did not report one.

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.

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.