Widget Installation

Install the Widget.

Drop in a single script tag to start collecting feedback.

Developer Widget

For developer projects collecting bug reports and technical feedback. The widget captures browser metadata, console errors, and optional screenshots when the submitter chooses to include one.

<script
  src="https://grova.dev/grova-widget.js"
  data-source="your-app"
  data-key="YOUR_PROJECT_KEY"
></script>

Business Widget

For business projects collecting customer feedback with sentiment analysis and recovery workflows. Includes email capture for follow-up actions.

<script
  src="https://grova.dev/grova-business-widget.js"
  data-source="your-business"
  data-key="YOUR_PROJECT_KEY"
></script>

Configuration Options

Customize the widget behavior with data attributes on the script tag.

Attribute	Required	Description
`data-source`	Yes	Identifier for your app or business. Used to route feedback to the correct project.
`data-key`	Yes	Your publishable project collection key. Found in project settings.
`data-theme`	No	Widget color theme. Options: "light", "dark", or "auto" (default). Auto matches the user's system preference.
`data-position`	No	Widget button position. Options: "bottom-right" (default), "bottom-left", "top-right", "top-left".

Customization Notes

The widget injects a floating button and modal into your page. It does not affect your existing styles or layout.
The developer widget automatically captures console errors and browser metadata. No additional setup is required.
For the business widget, email capture is enabled by default so you can send follow-up actions to customers.
The widget respects Content Security Policy headers. If you use CSP, add grova.dev to script-src and the Grova API host to connect-src.