Create a project
Sign up or sign in to SignalBoard. Create a new project from the dashboard. Each project gets its own unique widget ID.
Copy the snippet
Go to your project's Install page to find your snippet with your unique widget ID. Or use this template and replace YOUR_WIDGET_ID:
<!-- Add this script to your HTML -->
<script
src="https://cdn.signalboard.io/widget.js"
data-widget-id="YOUR_WIDGET_ID"
async>
</script>
<!-- Place this div where you want the widget -->
<div id="signalboard-widget"></div>Add to your site
Paste the <script> tag anywhere in your HTML, ideally before the closing </body> tag.
Place the <div id="signalboard-widget"> element where you want the widget to appear on the page.
Framework note
For React/Next.js/Vue apps, add the script to your main HTML template or use a script loader. The widget works with any framework.
Send a test submission
Load your page with the widget installed. Click the widget, submit some test feedback, and verify it appears in your SignalBoard inbox.
You're done!
Your widget is live. Customize colors and text in Widget Settings anytime.
Troubleshooting
Widget not showing?
- Check that the script tag has the correct
data-widget-id - Verify the div with
id="signalboard-widget"exists on the page - Open browser dev tools and check for console errors
Submissions not appearing?
- Make sure you're checking the correct project in SignalBoard
- Wait a few seconds—submissions appear near-instantly but there may be brief delay
- Check if the widget ID matches your project