Add an install popup to Wix — setup guide

Key takeaways

• Use dashboard Custom Code, not an HTML iframe element.
• Wix requires a published site and connected domain for this workflow.
• Load the snippet once across all pages.
• Verify the connected domain rather than an editor preview.

Before you start

• A published Wix site with a connected domain.
• Access to Settings → Custom Code on your account.
• An InstantPWA popup configured for the connected domain.

Step-by-step for Wix

1. Step 1
   Copy your popup’s install code

   Save the published connected-domain address in InstantPWA and copy the snippet for that popup. Use your own ID, not the example placeholder.

   <script src="https://instantpwa.com/api/public/embed.js" data-widget-id="YOUR_WIDGET_ID" defer></script>

2. Step 2
   Open Wix Custom Code

   In the site dashboard, open Settings → Custom Code → Add Custom Code. Name the entry so it is easy to find later.

3. Step 3
   Choose page scope and placement

   Paste the script. Choose All pages and load once, then Body-end placement and apply. An HTML embed element is an iframe and is not a substitute for site-wide code.

4. Step 4
   Verify on the published domain

   Open your connected domain in Safari or Chrome and run the InstantPWA install check. If consent settings gate the script, test after the relevant consent is given; do not bypass consent requirements.

Common Wix gotchas

• Wix Custom Code is not tested through the editor preview.
• If Custom Code is unavailable, check domain connection and current account eligibility in Wix; do not assume an old Business/VIP plan name applies.
• A service worker must be served on the same origin as the page it controls. Hosting sw.js on an unrelated CDN does not add offline support to Wix.
• A popup view confirms script execution, not permission to send notifications.

FAQ

Platform documentation

• Wix: embedding custom code