Embeddable Widget
The FeedbackPulse widget lets tenants embed a feedback form directly on their own website with a single line of code.
Installationโ
Add this script tag anywhere on your website:
<script src="https://yourdomain.com/widget/{campaign-slug}.js"></script>
Replace:
yourdomain.comwith your FeedbackPulse domain{campaign-slug}with your campaign's slug
Example:
<script src="https://feedback.acmecorp.com/widget/rate-our-dashboard.js"></script>
How It Worksโ
- The script injects a floating feedback button on the page (typically bottom-right corner)
- When clicked, an iframe opens with the full feedback form
- The form supports all campaign features (star rating, NPS, text, photo upload, etc.)
- After submission, the user sees a thank-you message
- The iframe closes automatically
Customizationโ
The widget inherits the campaign's configuration:
- Which fields are enabled
- Whether email/OTP is required
- Whether reCAPTCHA is active
- Branding colors from the tenant settings
Technical Detailsโ
| Aspect | Detail |
|---|---|
| Script size | Lightweight (~5 KB) |
| Dependencies | None -- vanilla JavaScript |
| Iframe URL | /widget/{slug}/frame |
| Rate limit | 120 requests/minute |
| CSRF | Exempt (cross-domain embedding) |
| Cookies | Third-party cookies not required |
Best Practicesโ
- Place the script before the closing
</body>tag - Test the widget in both desktop and mobile browsers
- Make sure your campaign is set to "Active" status
- The widget works on any website (WordPress, Shopify, React, etc.)
Troubleshootingโ
| Issue | Solution |
|---|---|
| Widget not showing | Check that the campaign slug is correct and the campaign is active |
| CORS errors | FeedbackPulse includes proper CORS headers for widget endpoints |
| Widget blocked by CSP | Add your FeedbackPulse domain to your Content Security Policy |
| Form not submitting | Check browser console for errors |
Next Stepsโ
- Feedback Campaigns -- configure the form