Skip to main content

The Harvestr feedback widget

Install Harvestr's Feedback Widget to gather user feedback and update them on its status automatically.

Written by Marina Salmon

What is the Harvestr feedback widget?

The Harvestr feedback widget lets you gather structured feedback directly from your users. This guide walks you through integrating it into your product, website, or mobile application.

Start from the widget settings in Harvestr, where you configure its appearance, behaviour, and question template.

Prerequisites

  • a Harvestr Editor account to configure the widget

  • the ability to add a script to your website or app — you may need a developer for the SDK option

Installation options

Basic JavaScript installation

For a quick, straightforward setup. Ideal for website integrations and requires minimal coding.

SDK integration

For more advanced scenarios, including mobile apps. Offers greater flexibility and customization.

Configuring the widget

Content and styles

  • Action and background colors — match the widget to your brand.

  • Open style — choose Menu to display it on the sides, or Modal for a central pop-up.

  • Launcher style — floating circle, side vignette with text, or side vignette without text.

  • Launcher text — for side vignettes with text, customize the wording to guide users.

  • Launch position — choose right or left alignment, and adjust the vertical and horizontal spacing to fit your layout.

Installing the widget

Once configured, copy the provided code snippet and paste it before the </body> tag on every page where you want the widget to appear.

The SDK script extends the widget's capabilities, letting you:

  • trigger the widget from specific parts of your app, such as a button click

  • integrate the widget into mobile applications

Defining your question template

The widget collects feedback through a set of questions you define. This structures what users tell you and makes the results easier to work with.

The widget's question template is configured in the widget settings and is separate from the feedback templates used by internal integrations like Slack and the Chrome extension.

The first question is mandatory

The first question is required and becomes the title of the feedback, so it should capture the main topic at a glance.

For example: "What is the main issue you're experiencing?" or "What feature would you like to see improved?"

Subsequent questions

Tailor the rest to your goals, choosing among four question types:

  • Input — short, direct answers

  • Textarea — longer, descriptive feedback

  • Single select — users choose one option from a list

  • Multi select — users choose several options

Select answers become labels. Single and multi-select answers are attached to the feedback as labels in Harvestr. If a label already exists, we reuse it rather than creating a duplicate.

This makes select questions worth designing carefully — they feed your taxonomy, your Custom Inboxes, and your Rollup fields.

Two things to keep in mind when writing questions:

  • Keep them clear and short. Long questions reduce completion.

  • Keep them relevant to the user's experience and to the insight you actually want.

Once customized, the template is live in the widget with no further action.

Example template

  1. Mandatory title question: "What feature do you need help with?"

  2. Follow-up: "Please describe the issue you're facing." (Textarea)

  3. Rating: "How would you rate your overall experience?" (Single select: Poor, Fair, Good, Excellent)

  4. Additional feedback: "Any other suggestions for improvement?" (Textarea)

What your end users see

Submitting feedback

Users fill out your template and click Submit to share their concerns or suggestions, without leaving your product.

To keep feedback trustworthy and prevent spam, we ask for their email. First-time users receive a one-time password by email to verify their identity.

On subsequent submissions from the same browser, users are recognized automatically.

Following feedback status

Users can track what happens to their feedback through the Follow tab in the widget. Each item shows one of three statuses:

  • Read — the feedback has been received and reviewed in Harvestr.

  • Prioritized — it's been linked to a Discovery and is being considered.

  • Shipped — the linked Discovery reached a completed-type state.

This keeps users informed and shows them their input goes somewhere, which tends to produce more and better feedback over time.

Did this answer your question?