Add an install prompt to Bubble
To add an install prompt on Bubble, paste the InstantPWA snippet into Script/meta tags in header via Settings → SEO/metatags → Script/meta tags in header. 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 Bubble site as an app.
Steps
- 1
Open Script/meta tags in header
Go to Settings → SEO/metatags → Script/meta tags in header.
- 2
Paste the InstantPWA snippet
Drop the one-line async script tag in the Bubble 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 Bubble so the change goes live — most builders require an explicit publish step before custom code runs.
- 5
Verify on a phone
Open your live Bubble URL on a mobile device (not the editor preview) to confirm the popup renders.
Constraints to know
- Requires a paid Bubble plan with a custom domain — installs behave inconsistently on the shared *.bubbleapps.io subdomain without HTTPS custom domain.
- Bubble reloads the whole page for most workflow navigation, so the install popup re-evaluates its display rules each URL change rather than staying mounted like an SPA.
FAQ
Does the install prompt work on iOS Bubble 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 Bubble besides Settings?+
No — the head snippet is the only integration point; InstantPWA hosts the manifest and service worker for you.