The floating widget is a fixed-position button rendered in JavaScript on the frontend. It is built on page load (or after a trigger event) and appended to <body>.
Widget structure
[Trigger button] — fixed, bottom-right or bottom-left
[Panel] — slides up when trigger is clicked
[Header] — "Share Feedback" + close button
[Body]
Type select
Subject input (optional)
Message textarea (required)
Screenshot attach button (if enabled)
Email input (optional)
Star rating
[Footer]
Link to dedicated feedback page (if configured)
Send Feedback buttonAuto-fill
If a user is logged into WordPress, their display_name and user_email are pre-filled into the widget email field and the page-form name/email fields. This uses data passed via wp_localize_script — no client-side user data fetch.
Trigger modes
Configured in Settings → Widget Behavior → Trigger Mode:
| Mode | Behaviour |
|---|---|
| Immediately | Widget appears as soon as the page loads |
| After a delay | Widget appears N seconds after page load |
| After scroll depth | Widget appears after the visitor scrolls X% of the page |
| Exit intent | Widget appears when the cursor leaves the top of the viewport |
Excluded pages
Post/page IDs listed in Settings → Show/Hide Rules → Excluded Post IDs will not render the widget, even when the widget is globally enabled.