Widget settings
Everything below is set in the dashboard under Settings and applied at runtime; no redeploy of your site is needed.
| Setting | Values | What it does |
|---|---|---|
mode | full · two · single · rate_only | Which intents the segmented control shows. single is one box sent as a general note; rate_only is faces plus an optional note. |
intents | subset of rating, suggestion, bug | Used with mode=two. |
position | bottom-right · bottom-left · edge-right · edge-left · none | edge-* is a rotated tab on the side of the viewport; none hides the pill so you open the card from your own link with window.backwire.open(). |
bubble_style | icon · icon_label · label | icon shows the label for 3 seconds on a visitor's first page in a session, then collapses. |
accent | hex colour | Used only for Send, focus rings and the selected face. Light colours are darkened until the Send label reaches 4.5:1 contrast. |
radius | round · soft · square | 14 px, 8 px or 2 px corners. |
theme | auto · light · dark | auto follows the visitor's system setting. |
labels | per-locale strings | bubble, rate, idea, problem, the three questions, single_prompt, sent, nudge. The widget picks navigator.language, then the base language, then English. |
show_on_paths / hide_on_paths | path globs | * matches within a segment, ** across segments. hide wins. |
first_show_delay_ms | number | Delay before the pill appears (after the page is idle). |
hide_on_scroll | boolean | Fade the pill out while scrolling; it returns 600 ms after scrolling stops. |
show_footer | boolean | The “Feedback by BackWire” link. Always on for the free plan. |
JavaScript API
window.backwire.init({ pk })— mount programmatically (SPA frameworks).window.backwire.open()/window.backwire.close()— open or close the card, e.g. from your own “Send feedback” link.window.backwire.identify({ id, email })— attach a signed-in user; the report gets their contact with follow-up allowed and the nudge is skipped.window.__backwire_skip_net = truebefore the script — skip the fetch/XHR hook if another tool already wraps them.