Feedback

How to embed the feedback widget

Overview

The feedback widget is the easiest way to collect feedback directly from your users without sending them to a separate page. Userorbit supports several embedding options depending on where and how you want to collect feedback: an in-app widget, a standalone page, or a direct link. This guide covers how to set up each one.

Option 1: In-App Widget

The in-app widget adds a floating button to your website or application. When users click it, a feedback form slides in from the side of the screen.

Setup

  1. Go to Settings → Widget in your Userorbit dashboard.
  2. Copy the JavaScript embed snippet.
  3. Paste the snippet into your website's HTML, just before the closing </body> tag.

Configuration

You can customize the widget directly from the settings page:

  • Button color — Match your brand colors so the widget feels native to your app.
  • Button position — Choose bottom-right or bottom-left placement.
  • Button text — Change the default label (e.g., "Feedback", "Share an idea", "Report a bug").
  • Default board — Pre-select a board so feedback goes to the right place automatically.
  • Theme — Light or dark mode to match your app's appearance.

After saving your configuration, changes are reflected immediately wherever the widget is embedded. No code changes needed.

Option 2: Standalone Feedback Page

If you prefer to send users to a dedicated page rather than embedding a widget, use the public feedback portal.

  1. Go to Settings → Portal.
  2. Enable the public portal if it is not already active.
  3. Copy the portal URL.
  4. Link to it from your app's navigation, help menu, or footer.

The portal displays all your public boards, existing feedback items, and a submission form. Users can browse existing feedback, vote on items they care about, and submit new ideas — all from one page.

Every feedback board has its own unique URL. You can link directly to a specific board if you want to route users to a particular category of feedback.

  1. Navigate to the board in your dashboard.
  2. Click Share to copy the board's public link.
  3. Use this link in emails, help docs, in-app prompts, or anywhere else you want to collect targeted feedback.

This is useful when you want to collect feedback about a specific feature or area. For example, you might add a "Give feedback on this feature" link inside a particular section of your app that points directly to the relevant board.

Embedding in Single-Page Applications

If your app is a single-page application (SPA) built with React, Vue, Next.js, or similar frameworks, the embed snippet works the same way. Add the script tag to your main HTML template (usually index.html or your root layout). The widget initializes once and persists across route changes.

For more control, you can initialize the widget programmatically using the JavaScript API exposed by the embed script. This lets you:

  • Open the widget in response to a custom button click instead of using the default floating button.
  • Pre-fill form fields based on the current page or logged-in user.
  • Pass user identification data so feedback is automatically attributed to the right account.

Tips

  • Place the widget on pages where users are most likely to have feedback — dashboards, settings pages, and new feature areas.
  • If you use both the widget and the portal, they share the same boards and data. Feedback submitted through either channel appears in the same place.
  • Test the widget on mobile devices. It is responsive by default, but verify the experience matches your expectations.

Was this page helpful?