Install the website feedback widget
Add a floating or inline widget, select a rating scale, and verify delivery in your inbox.
The standalone widget runs from a script tag. You need an inbox key and an organization key with collect scope. A collect key placed in browser code is visible to visitors; do not substitute a read, write, admin or personal key.
Install a floating widget
Place this before the closing </body> tag, replacing the two placeholders:
<script
src="https://pollenate.dev/widget.js"
data-api-key="YOUR_COLLECT_ONLY_ORGANIZATION_KEY"
data-inbox-key="YOUR_INBOX_KEY"
data-type="emoji"
data-theme="auto"
data-position="bottom-right"
data-prompt="How was this experience?"
defer
></script>Submit a test response and check the inbox. The script is the collector; the inbox key selects its destination. The API key must belong to the destination's organization and, for a brand-scoped key, its brand.
Choose a type
| Type | Input |
|---|---|
thumbs |
Down/up, scores 0 and 1 |
stars |
1–5 stars |
csat |
1–5 satisfaction |
nps |
0–10 recommendation scale |
emoji |
Five sentiment choices, scores 1–5 |
text |
Written feedback |
Floating positions are bottom-right, bottom-left, top-right and top-left. Theme accepts light, dark or auto; auto follows the system preference.
Render inline
Create the target element before the script. data-container selects it and implies inline mode:
<div id="article-feedback"></div>
<script
src="https://pollenate.dev/widget.js"
data-api-key="YOUR_COLLECT_ONLY_ORGANIZATION_KEY"
data-inbox-key="YOUR_INBOX_KEY"
data-type="thumbs"
data-container="#article-feedback"
data-prompt="Was this article helpful?"
defer
></script>Use a selector that identifies the intended element. A missing container prevents the inline placement from working as expected.
Context and impressions
data-context accepts a JSON object. data-track-impressions="false" disables widget impression tracking; it does not disable submissions. data-strip-query-params="true" strips query parameters from tracked page URLs. Review any context and page URL before sending it.
<script
src="https://pollenate.dev/widget.js"
data-api-key="YOUR_COLLECT_ONLY_ORGANIZATION_KEY"
data-inbox-key="YOUR_INBOX_KEY"
data-context='{"feature":"checkout","release":"2026-11"}'
data-strip-query-params="true"
defer
></script>For troubleshooting, inspect the browser Console and Network panels. 401 points to a missing/invalid key, 403 to access or scope, 404 to routing, and 429 to a rate or daily limit. A blocked network request may be a Content Security Policy problem. Use React for component-based lifecycle control and themes for appearance.