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.
Everything starts from Settings > Integrations > Feedback widget, where you install the widget and configure its appearance and its feedback form.
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
Set up the widget
On the Feedback widget page, click Set up widget. Harvestr creates a widget with a default form you can edit. The page then shows three cards: Install, Appearance and Feedback form.
Installing the widget
In the Install card, pick an Install method:
Script tag: for most sites. A quick, straightforward setup that requires minimal coding.
SDK: for more advanced scenarios, including mobile apps. It uses the default appearance, and you open and close the widget from your own code with
window.HFC("open")andwindow.HFC("close"), for example from a button click.
Click Copy code and paste the snippet before the </body> tag on every page where you want the widget to appear.
Appearance settings are part of your snippet. After changing them, copy the snippet again and replace it on your site. Changes to the feedback form apply without updating the snippet.
Configuring the widget's appearance
In the Appearance card:
Button color and Header color: match the widget to your brand. The button color applies to buttons, links and highlights; the header color to the header background.
Opens as: a side panel or a centered window.
Launcher: how users open the widget, for example a floating circle or a tab on the side of the screen, with or without text.
Launcher text: for a side tab with text, customize the wording to guide users.
Position: the side of the screen and the distance from the edges.
Defining your feedback form
The widget collects feedback through a set of questions you define in the Feedback form card. This structures what users tell you and makes the results easier to work with.
The widget's feedback form 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. To reword it, open the ⋯ menu on the Title row and click Edit.
For example: "What is the main issue you're experiencing?" or "What feature would you like to see improved?"
Subsequent questions
Click Add question, then fill in the Question, its Type, whether it's Required, and an optional Help text shown under the question. Four types are available:
Short text: short, direct answers
Long text: longer, descriptive feedback
Choice: users choose one option from a list
Multiple choice: users choose several options
Use the ⋯ menu of a question to Edit, Move up, Move down or Delete question.
Options become labels. Each option of a Choice or Multiple choice question is attached to the feedback as a label in Harvestr. If a label already exists, we reuse it rather than creating a duplicate.
This makes these 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 form is live in the widget with no further action.
Example form
Mandatory title question: "What feature do you need help with?"
Follow-up: "Please describe the issue you're facing." (Long text)
Rating: "How would you rate your overall experience?" (Choice: Poor, Fair, Good, Excellent)
Additional feedback: "Any other suggestions for improvement?" (Long text)
What your end users see
Submitting feedback
Users fill out your form 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.