General Installation
Get up and running in under 5 minutes with a simple script tag. No complex setup required.
Get Your Project ID
First, you need the unique ID for the project you want to embed.
- Navigate to the Projects page in your dashboard.
- Select the project you wish to install.
- Open the Setup page for that project.
- Your unique Project ID will be displayed there. Copy it.
Add the Script Tag
Paste the SupaFeedback script near the end of your HTML, before the closing body tag.
- Include
<script src="https://www.supafeedback.com/widget.js?pid=YOUR_PROJECT_ID" defer></script> - Replace
YOUR_PROJECT_IDwith the ID you copied. - The script loads once, fetches your project trigger settings, and attaches handlers automatically.
Choose a Trigger (optional)
On the project Setup page, pick Click or Page load. You can also turn on a floating Feedback button.
- Click (default): visitors open the widget from a data-sf element.
- Page load: the popup appears when the page finishes loading, and is closable with ×.
- Page load options: Show once per day, Don't show after submit, and Exclude paths.
- Floating button (optional): inject a built-in chip so the script tag is enough.
Add a Trigger Button
Any element with the data-sf attribute opens the feedback widget. Required for Click mode unless the floating button is on; optional for Page load.
- Add
data-sfto a button or link. - Example:
<button data-sf>Give Feedback</button> - Click the element to open the widget and send feedback to your inbox.