---
title: SupaFeedback
description: Collect feedback with screenshots, run targeted rating surveys, keep spam out of your inbox, and announce shipped updates on your website.
---

# SupaFeedback

The feedback widget that closes the loop.

Capture issues and ideas with screenshots, run quick rating surveys, keep obvious spam out of your inbox, and announce shipped updates on the same widget your visitors already see.

Free to start. No credit card required.

Now in v0.20.0: urgent reports can skip Daily digest or Off and arrive immediately.

## One connected workflow

### Make it effortless to report

Use your own button or turn on the built-in floating launcher. Customers can explain the moment and attach exactly what they saw.

### Know who and what happened

Identify signed-in customers by name and email, then receive the report, screenshot, and technical context in one place.

### Close the loop automatically

Project owners and invited members choose Instant, a daily digest, or Off for new-feedback emails. Email the submitter when work is Done, and announce the update to everyone visiting your site.

## Targeted 1–5 survey campaigns

Ask one focused question at the right moment without replacing the regular feedback widget.

- Create a 1–5 rating survey with custom endpoint labels
- Target an exact path such as `/setup` or a route group such as `/onboarding/*`
- Add an optional delay and show each campaign once per visitor
- A matching survey takes priority over the page-load feedback popup for that visit
- The floating launcher and `data-sf` buttons continue to open the regular feedback form
- Review shown count, conversion rate, average score, rating distribution, page context, and optional comments on a dedicated results page

## Announce shipped updates on your website

Publish a short update for everyone visiting your site — not only the person who submitted a request.

- From the project inbox, use **Announce update** to prepare a title, short description, and optional link, then publish
- For completed feedback, use the separate AI suggestions beside **Title** and **Short description** to draft a punchy headline or concise summary; review and edit before publishing
- Marking feedback Done can still open the same card. Skip if you only want the usual status email
- A What's new card appears in the same corner as your widget. Each visitor sees it once and can dismiss it
- No extra script. The card sits above the launcher and does not cover a survey
- The inbox stacks published cards, with Unpublish when you want the update off the site
- The original requester still gets the Done email when the card is tied to a ticket

## Keep spam out of your feedback inbox

New widget feedback gets a quick AI check, so your inbox stays focused on useful product feedback instead of obvious promotions, scams, and gibberish.

- Only clearly unhelpful submissions are moved to Spam; genuine issues, ideas, questions, and short messages stay in the inbox
- Spam has its own folder and does not trigger new-feedback or browser notifications; see why a submission was flagged
- Review and restore anything from Spam, or mark a report as spam yourself
- If the AI check is unavailable, the report stays in the normal inbox

## Install your way

Add the script and enable the floating launcher in project Setup:

```html
<script src="https://www.supafeedback.com/widget.js?pid=YOUR_PROJECT_ID" defer></script>
```

Use your own button and attach an identified customer:

```html
<button data-sf data-sf-name="Maya Chen" data-sf-email="maya@acme.app">
  Give feedback
</button>
```

Or identify the current signed-in customer for every widget trigger:

```js
window.SupaFeedback.identify({
  name: "Maya Chen",
  email: "maya@acme.app"
});
```

Coding agents can start at [`/llms.txt`](/llms.txt), read the markdown [Widget Installation Guide](/docs.md), and submit structured JSON through `POST /api/feedback`.

## Features

- Private screenshot capture and upload
- Automatic browser, device, location, page, and user-agent context
- AI spam protection with a separate reviewable Spam folder
- Click, page-load, floating-launcher, and programmatic triggers
- Targeted 1–5 survey campaigns with page rules and results
- Shipped update cards from the inbox or when feedback is marked Done
- Per-project theme, color, logo, widget links, launcher label, and widget position
- Identified visitors by name and email
- Live inbox plus Instant, digest, or Off emails, immediate critical alerts, and browser notifications
- New, Planned, In Progress, Done, and Archived workflow
- Submitter emails when feedback moves to In Progress or Done, with an optional personal note on Done
- Agent-readable markdown pages and HTTP feedback API

## Frequently asked questions

### How do I add the feedback widget to my website?

Paste one script tag with your project ID before the closing body tag. Then turn on the floating Feedback button in Setup, or add the data-sf attribute to any button or link you already have.

### Does SupaFeedback work with React, Next.js, Vue and WordPress?

Yes. The widget is a single vanilla JavaScript file, so it works on any site that can load a script tag, including React, Next.js, Vue, WordPress and plain HTML.

### Who can see the screenshots customers attach?

Screenshots are private. Only people with access to the project can view them. Customers can capture the current tab or upload a PNG, JPEG or WebP image.

### Can I know which customer sent the feedback?

Yes. Call SupaFeedback.identify() with a name and email after sign-in, or add data-sf-name and data-sf-email to your trigger, and every report shows who sent it.

### How does spam protection work?

New widget feedback gets a quick AI check. Only clearly unhelpful submissions, like promotions and gibberish, move to a separate Spam folder that never triggers notifications. You can review and restore anything, and if the check is unavailable the report stays in the inbox.

### Will I miss urgent feedback if I use the daily digest?

No. Critical alerts are on by default. Describe what counts as critical, such as failed payments or broken login, and matching reports are emailed immediately even when your email preference is Daily digest or Off.

### Can AI agents or servers submit feedback?

Yes. Send JSON to POST /api/feedback with your project ID and a message. Agents can start at /llms.txt and read every docs page as Markdown.

### Is SupaFeedback free?

SupaFeedback is free to start and no credit card is required. Create a project and install the widget in a few minutes.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.