Add an install prompt to WordPress
To add an install prompt on WordPress, paste the InstantPWA snippet into header.php via Appearance → Theme File Editor → header.php, or a code-injection plugin like WPCode. The popup captures the browser's native install signal where supported and falls back to a guided walkthrough on iOS Safari, so every visitor sees a clear path to installing your WordPress site as an app.
Steps
- 1
Open header.php
Go to Appearance → Theme File Editor → header.php, or a code-injection plugin like WPCode.
- 2
Paste the InstantPWA snippet
Drop the one-line async script tag in the WordPress head section — no build step or dependency install.
- 3
Configure the trigger
In your InstantPWA dashboard, set when the popup appears — on page load, after N seconds, or after a scroll/engagement threshold.
- 4
Publish
Save/publish in WordPress so the change goes live — most builders require an explicit publish step before custom code runs.
- 5
Verify on a phone
Open your live WordPress URL on a mobile device (not the editor preview) to confirm the popup renders.
Constraints to know
- Editing header.php directly is wiped out on theme updates — use a child theme or WPCode's header/footer injection to survive updates.
- Works identically across Elementor, Divi, Astra and Kadence since the snippet lives in the theme shell, not the page builder's canvas.
FAQ
Does the install prompt work on iOS WordPress visitors?+
iOS Safari never fires the native beforeinstallprompt event, so InstantPWA shows a share-sheet walkthrough instead — visitors still get a clear add-to-home-screen path.
Will this conflict with other scripts on my site?+
No — InstantPWA is a single first-party async script with no third-party dependencies, so it doesn't block or compete with analytics or chat widgets.
Do I need to touch anything else in WordPress besides Appearance?+
No — the head snippet is the only integration point; InstantPWA hosts the manifest and service worker for you.