Self-Hosted Web Push Integration Guide
📁 Getting Started
🕐 Updated 1 week ago
Self-Hosted Web Push Integration Guide
To enable native web push notifications on your website, follow these simple integration steps:
Step 1: Download your SDK Bundle
Go to your Websites Dashboard, find your registered website, and click the Download SDK button. This will download a pre-configured .ZIP package containing:
sdk.js(pre-compiled with your dynamic site key and backend URL)sw.js(our standard background service worker)
Step 2: Upload Files to your Server Root
Extract the .ZIP package and upload both sdk.js and sw.js directly into the root directory of your website (usually named public_html, public, or www).
Ensure they are publicly accessible in your browser at:
https://yoursite.com/sdk.jshttps://yoursite.com/sw.js
[!IMPORTANT] Web browsers require the service worker (
sw.js) to be hosted exactly at the root of your domain. If placed in a subdirectory, the browser will restrict its security scope and notifications will fail.
Step 3: Paste the Integration Script
Copy and paste this single script tag inside the <head> of your website:
<script src="/sdk.js" defer></script>
Step 4: Verify & Test
- Clear your browser cache and open your website.
- Tap or click anywhere on the page—the browser's native notification prompt will automatically slide down!
- Click Allow. Your device will now appear under the Subscribers list in your dashboard, ready to receive live push campaigns.