Widget settings

Everything below is set in the dashboard under Settings and applied at runtime; no redeploy of your site is needed.

SettingValuesWhat it does
modefull · two · single · rate_onlyWhich intents the segmented control shows. single is one box sent as a general note; rate_only is faces plus an optional note.
intentssubset of rating, suggestion, bugUsed with mode=two.
positionbottom-right · bottom-left · edge-right · edge-left · noneedge-* 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_styleicon · icon_label · labelicon shows the label for 3 seconds on a visitor's first page in a session, then collapses.
accenthex colourUsed only for Send, focus rings and the selected face. Light colours are darkened until the Send label reaches 4.5:1 contrast.
radiusround · soft · square14 px, 8 px or 2 px corners.
themeauto · light · darkauto follows the visitor's system setting.
labelsper-locale stringsbubble, 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_pathspath globs* matches within a segment, ** across segments. hide wins.
first_show_delay_msnumberDelay before the pill appears (after the page is idle).
hide_on_scrollbooleanFade the pill out while scrolling; it returns 600 ms after scrolling stops.
show_footerbooleanThe “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 = true before the script — skip the fetch/XHR hook if another tool already wraps them.