Install StageWhisper in Plain HTML
Plain HTML is the canonical StageWhisper install — one async script tag, no build step, no SDK. It works on any website regardless of stack; the other guides in this section exist only to show the tag’s natural home in each framework, and every one of them installs this same snippet.
Prerequisites
- A StageWhisper site created in the dashboard.
- Your website’s origin on the site’s origin allowlist — enable the localhost toggle for local testing.
Add the snippet
-
Copy the one-liner below and swap
pub_your_site_keyfor the public site key shown on your site’s install page in the dashboard.Loader snippet <script async src="https://cdn.stagewhisper.co/loader.js" data-sw-key="pub_your_site_key"></script> -
Paste it just before the closing
</head>tag on every page where you want feedback — or once in the shared layout or include, if your static host has one. -
Deploy. The tag is
async, so it never blocks your page render — the widget mounts quietly once the page is up.
On static hosts — Netlify, GitHub Pages, S3, or any CMS that lets you edit the page head — that is the whole install. The tag is plain HTML, so there is no build step to configure and nothing to compile.
Running a strict Content Security Policy? The Content Security Policy guide lists the exact directives to allow and where the nonce goes.
Verify
Refresh your app, then watch the site’s install status in the dashboard — it flips the moment the first ping arrives.
Widget not showing up? Head to Troubleshooting for the usual suspects — blocked origins, CSP, localhost, and stale config.