Installing the Widget

Last updated: March 2026

Add UserSignal to your app with a single script tag. No build steps, no dependencies, no npm packages.

1. Get your API key

Go to your Project Settings in the UserSignal dashboard and copy your API key.

2. Add the script tag

Paste this code before the closing </body> tag on every page where you want the widget to appear:

HTML

<script src="https://app.usersignal.co/widget.js"
  data-key="YOUR_API_KEY"
  data-user-id="USER_ID"
  data-user-name="USER_NAME"
  data-user-email="USER_EMAIL">
</script>

3. Replace the placeholders

YOUR_API_KEY — your project API key from the dashboard
USER_ID — a unique identifier for the logged-in user
USER_NAME — the user's display name (optional)
USER_EMAIL — the user's email address (optional)

4. Verify

Refresh your app. You should see the UserSignal bell icon in the bottom-right corner. Click it to open the widget.