Send web push notifications from Ghost
Web push on Ghost works through the same InstantPWA snippet you add for install prompts — placed in Code Injection → Site Header via Ghost Admin → Settings → Code Injection → Site Header. Once a visitor opts in, you can send push notifications from your InstantPWA dashboard to anyone who granted permission, including installed home-screen users on iOS 16.4+.
Steps
- 1
Open Code Injection → Site Header
Go to Ghost Admin → Settings → Code Injection → Site Header.
- 2
Paste the InstantPWA snippet
Drop the one-line async script tag in the Ghost head section — no build step or dependency install.
- 3
Enable push in your dashboard
Turn on Web Push in InstantPWA settings and upload your notification icon and default badge.
- 4
Publish and collect opt-ins
Once live on Ghost, the popup asks for notification permission after install (or standalone, if you enable prompt-first push).
- 5
Send a test push
Send a test notification from the dashboard to your own opted-in browser before sending to all subscribers.
Constraints to know
- Works identically on Ghost(Pro) hosted and self-hosted Ghost 4+; no theme edit required since Code Injection is theme-independent.
- AMP versions of posts (if enabled) strip third-party scripts by spec, so the popup only appears on the canonical (non-AMP) page.
FAQ
Does web push work without the visitor installing the app?+
On Chromium browsers and desktop, yes. On iOS Safari, push requires the visitor to add the site to their home screen first (iOS 16.4+).
Can I segment who receives a push?+
Yes — the InstantPWA dashboard supports targeting by page visited, device type and custom events you send from your site.
Is there anything Ghost-specific I need to configure for push?+
No — push registration is handled entirely by the InstantPWA snippet once it's live on Ghost; there's no separate push API key to manage.