UserHero Docs
Use Cases

Feedback & Bug Reports

Collect product feedback, capture bugs with screenshots, and gather feature requests

Feedback & Bug Reports

Capture product feedback from your users while they're actively using your app. UserHero widgets give you floating buttons, embedded triggers, and screenshot capture — so users can report issues in context.

General Feedback Widget

A floating button that's always visible on screen, inviting users to share feedback at any time.

Setup

  1. Go to Widget Builder in your dashboard
  2. Click Create Widget
  3. Choose the Feedback template
  4. Set widget type to Floating
  5. Customize the button text (e.g., "Send Feedback"), position, and colors
  6. Configure fields: message (required), category dropdown, rating (optional)
  7. Click Publish and copy the embed code

Embed

Add the script to your site's <head>:

<script
  src="https://userhero.co/widget.js"
  data-widget-id="YOUR_WIDGET_ID"
  defer
></script>

Tips

  • Place the button on the bottom-right for desktop users — it's the least intrusive position
  • Enable category selection so feedback is pre-sorted (bug, feature request, question, praise)
  • Use the rating field to quickly gauge sentiment

Route to Workflow

Create an intake rule on your Issues workflow:

ConditionValue
Widget IDYour feedback widget ID
Categorybug, feature request

Bug reports and feature requests automatically become Issues workflow items.


Bug Report with Screenshot

Let users capture exactly what they see. One-click screenshot capture includes browser info, device type, and page URL automatically.

Setup

  1. Create a new widget with the Bug Report template
  2. Set widget type to Floating
  3. Enable Screenshot Capture in widget settings
  4. Enable Browser Metadata (auto-captures browser, OS, screen resolution, page URL)
  5. Configure fields: title, description, steps to reproduce
  6. Publish and embed

How It Works for Users

  1. User clicks the bug report button
  2. Clicks Capture Screenshot — the widget highlights the current page
  3. User can annotate the screenshot (draw, highlight)
  4. Fills in description and submits
  5. You receive the report with the screenshot, metadata, and user context

Route to Workflow

Set up an intake rule:

ConditionValue
Templatebug-report
Default PriorityHigh
Default AssigneeQA Lead

All bug reports auto-create High-priority Issues assigned to your QA lead.


Feature Request Board

Collect feature ideas with an embedded widget placed near your product's feature areas.

Setup

  1. Create a new widget with the Feedback template
  2. Set widget type to Embedded
  3. Configure fields: title, description, category (pre-set to "feature request")
  4. Optionally set the category to a fixed value so users don't need to choose
  5. Publish and embed

Embed in Context

Place the widget near specific features:

<div id="feature-request-widget">
  <script
    src="https://userhero.co/widget.js"
    data-widget-id="YOUR_WIDGET_ID"
    data-type="embedded"
    data-container="feature-request-widget"
    defer
  ></script>
</div>

Tips

  • Place embedded widgets on your feature/product pages where users are most likely to have ideas
  • Pre-set the category to feature request to skip a form field
  • Use intake rules to route to a dedicated "Feature Ideas" Issues workflow

Next Steps

On this page