Widget Templates
Choose how your widget appears on your site and start from a preset
Widget Templates
The Template tab is the first tab of the widget builder. It has two parts:
- Widget Type: how the widget appears on your website.
- Choose a Preset: the fields the widget starts with, set up for a use case.
You can combine any widget type with any preset, and change every setting afterwards in the other tabs.
Creating a widget
- Open your project in the dashboard and click Create Widget.
- Enter a Widget Name. It's only for you and your team: visitors never see it.
- Pick a Widget Type and a preset.
- Adjust the Configuration, Styling and Display tabs.
- Click Create. The builder reopens the saved widget, now with its widget ID, link and QR code.
If the project already has as many widgets as your plan allows, you're asked to upgrade instead.
The Active switch at the top of the builder turns the widget on or off. A widget that isn't active doesn't show on your site and accepts no feedback.
Widget types
| Type | How it appears | Where you place it |
|---|---|---|
| Floating Button | A button fixed to the corner of the screen that opens the feedback popup | Nothing to add: it appears on every page your Display rules allow |
| Embedded Button | Your own button or link opens the feedback popup | Add an attribute to any button or element |
| Inline Form | The form sits inside your page | Add an empty element where the form should appear |
| PopUp | The feedback popup opens by itself after a delay, a scroll, or when the visitor is about to leave | Nothing to add: set the trigger in the Display tab |
| Link / QR Code | A hosted feedback page with its own link and QR code | Share the link or the QR code: no code on your site |
Every type except Link / QR Code needs the UserHero script on your website. Copy it from the Installation card on your project page, or see Installation.
Embedded Button
Once the widget is saved, the How to add button card shows the code with your widget ID:
<button data-userhero-trigger="WIDGET_ID">
Feedback
</button>Add the data-userhero-trigger attribute to any button, link or element on your page. Clicking it opens the feedback popup.
- The button is hidden on pages where the widget's Display rules don't allow it.
- If the widget is turned off or deleted, the button stays hidden. It never opens a different widget.
- A button without an ID (or still showing
YOUR_WIDGET_ID) opens the project's first Embedded Button widget.
Inline Form
Once the widget is saved, the How to embed the form card shows the element to add where the form should appear:
<div data-userhero-form="WIDGET_ID"></div>The same ID rules apply as for the Embedded Button. The form follows the widget's Display rules (pages and devices), also when visitors move between pages in a single-page app.
In the Styling tab, choose whether the form blends into your page or shows as a card with its own header. See Inline form.
After a visitor submits, the form shows a thank-you message and then resets for the next response.
PopUp
A PopUp widget opens the feedback popup on its own. Choose the trigger (after a delay, at a scroll depth, or on exit intent) and how often it shows in the Display tab. See Popup triggers.
Link / QR Code
A Link / QR Code widget is a feedback page hosted by UserHero, so you can collect feedback by email, social media, messaging apps, events or printed materials.
Once the widget is saved, the Share Your Feedback Form card shows:
- Feedback URL: the page address,
https://userhero.co/f/WIDGET_ID. Copy it or open it in a new tab. - QR Code: generated in the builder. Use Download SVG or Download PNG to print or display it.
The hosted page:
- Shows the form as a card, with the same corners and shadow as the popup window.
- Offers every option you set in the builder: the content block, rating, categories, message, custom fields, screenshot, attach image, audio and video recordings (Pro and Pro Max), Thumbs Up / Down or Yes / No, and the button actions.
- Offers the screenshot as an image upload only (an "Upload a screenshot" button), because a screen capture would only show the form page itself.
- Keeps the thank-you view after a visitor submits, with a "Submit another response" button.
- When the button action is Dismiss widget, hides the form and shows "You can close this page now."
- When the button action is Open link, opens the link in a new tab.
- Uses the form's title as the browser page title: your Expanded Widget Title, or the preset's default title (Send Feedback, Report a Bug or Rate Your Experience). Your internal widget name is never shown.
- With the Auto (System) theme, follows each visitor's light or dark system setting.
- Carries no UserHero branding, also in link previews, when you turn off Show UserHero Branding.
- Shows "This feedback form is currently not accepting responses." while the widget isn't active.
Link / QR Code widgets have no Display tab: page rules, device types and popup triggers don't apply to a hosted page.
Test page
All other widget types show a Test Page card in this tab, with a test link and QR code to try the widget before it goes live. See Test your widget.
Presets
Choose a Preset sets up the widget's fields for a use case. Presets are available on every plan and are grouped into four categories. Every preset turns screenshots, attachments and recordings off unless listed below.
Feedback
| Preset | Description | What it turns on |
|---|---|---|
| General Feedback | Collect general feedback with categories like bug, feature, and suggestion. | Message (required), category picker with Bug, Feature and Suggestion, optional screenshot |
| Bug Report | Focused bug reporting with screenshot capture and technical details. | Message (required), required screenshot, optional attached image |
| Feature Request | Collect feature ideas in your visitors' own words, with an optional screenshot. | Message (required), optional screenshot |
Surveys & Ratings
| Preset | Description | What it turns on |
|---|---|---|
| Rating / CSAT | Collect satisfaction ratings with 5-star scale and optional feedback. | Rating on the 1-5 Stars scale, optional message |
| NPS Survey | Net Promoter Score survey with 0-10 scale. Ask how likely users recommend you. | Rating on the 0-10 (NPS) scale, shown as numbers, optional message |
| Satisfaction Poll | Quick thumbs up/down poll. Minimal friction for fast feedback. | Thumbs Up / Down response buttons, message box (optional comment) |
| Quick Feedback | Yes/No binary question. Perfect for inline content feedback. | Yes / No response buttons only: one click sends the answer |
In a Satisfaction Poll one click on a thumb sends the answer; the comment is optional. To ask for a comment with every answer, turn on Require a message in the Configuration tab.
Lead Capture
| Preset | Description | What it turns on |
|---|---|---|
| Contact Form | Simple contact form with name, email, and message fields. | Name and Email fields, message (required) |
| Demo Request | Capture demo requests with name, email, company, and a message. | Name, Email and Company fields, message (required) |
| Newsletter Signup | Email-only signup form. Clean and minimal for list building. | Email field only |
Name, Email and Company are default fields that every project has, and presets add them on every plan. Name and Email are required and Company is optional; on Pro and Pro Max you can change that per widget in the Custom Fields card. A default field you've turned off in your project settings is left out.
Engagement
| Preset | Description | What it turns on |
|---|---|---|
| Announcement | Display news, updates, or messages. No form fields, just content. | Content block above the form and a "Got it" button that closes the widget (Dismiss widget) |
| Exit Intent Offer | Show an offer with an optional email field. Use it as a PopUp with the exit-intent trigger to catch visitors who are about to leave. | Content block and an optional Email field |
Write the content of the content block before you save an Announcement or Exit Intent Offer: a widget needs at least one field, custom field or content block with content.
For an exit offer, pick the PopUp widget type and the Exit Intent trigger in the Display tab.
Changing the preset
On a new widget, picking a preset applies it right away.
On a saved widget, the builder asks first: Changing preset will reset your configuration. Click Continue to replace the Configuration tab settings (fields, content block and submit button) with the preset's defaults, or Cancel to keep them. Your context capture settings and the Draggable Widget and Minimizable Widget settings are kept, and the Styling and Display tabs don't change.
Changing the widget type never resets anything.