Add an install prompt to Shopify
To add an install prompt on Shopify, paste the InstantPWA snippet into layout/theme.liquid via Online Store → Themes → Edit code → layout/theme.liquid. 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 Shopify site as an app.
Steps
- 1
Open layout/theme.liquid
Go to Online Store → Themes → Edit code → layout/theme.liquid.
- 2
Paste the InstantPWA snippet
Drop the one-line async script tag in the Shopify 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 Shopify so the change goes live — most builders require an explicit publish step before custom code runs.
- 5
Verify on a phone
Open your live Shopify URL on a mobile device (not the editor preview) to confirm the popup renders.
Constraints to know
- Runs on Basic, Shopify and Plus plans; theme.liquid edits are per-theme, so duplicate to any duplicate/backup themes too.
- Checkout.liquid is deprecated for script injection — Shopify now restricts checkout customization to Shopify Functions and the Script Editor app, so InstantPWA targets the storefront, not the hosted checkout.
FAQ
Does the install prompt work on iOS Shopify 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 Shopify besides Online Store?+
No — the head snippet is the only integration point; InstantPWA hosts the manifest and service worker for you.