Add an install popup to WordPress — setup guide

Key takeaways

• Permission to install plugins or edit site-wide scripts.
• Use your own popup ID in the script.
• Verify the published address, not an editor preview.
• Treat install guidance and full PWA capabilities as separate checks.

Before you start

• Permission to install plugins or edit site-wide scripts.
• A published HTTPS site.
• An InstantPWA popup configured for that site address.

Step-by-step for WordPress

1. Step 1
   Copy your popup’s code

   Create your popup, save its published website address and copy the install code. Replace the example ID with your own.

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

2. Step 2
   Install and verify: step 1

   Open your WordPress admin and install WPCode if you do not already have a header/footer tool.

3. Step 3
   Install and verify: step 2

   Open Code Snippets → Header & Footer.

4. Step 4
   Install and verify: step 3

   Paste the snippet into Footer and save changes.

5. Step 5
   Install and verify: step 4

   Clear any page cache, open your published site and run the install check.

6. Step 6
   Check what the home-screen icon actually does

   Test Safari on iPhone and Chrome on Android. Open the installed shortcut and confirm the destination. A positive script check is not proof of offline caching or push permission.

Common WordPress gotchas

• Self-hosted WordPress and WordPress.com have different plugin and code permissions; confirm access first.
• Avoid editing a parent theme directly: updates can remove the script.
• Clear caching plugins after adding code. A service-worker/offline plugin is a separate integration; avoid registering competing workers.

FAQ