Skip to main content

Feedback System

Feedbackfirst's feedback system is built on structure and validation. Every review covers four dimensions, and only feedback you validate earns credits. This keeps quality high and ensures you get actionable insights.

Structured Feedback Format

Structured feedback covers four dimensions:

1. What's Clear?

What works well? What's easy to understand? What impressed you?

This is where reviewers highlight the strengths of your product. It helps you understand what's working and what to keep.

Example:

"The onboarding flow is intuitive. I understood the core features in under 2 minutes. The dashboard is clean and responsive."

2. What's Confusing?

What needs better explanation? What's unclear in the UX? What could be simpler?

This is where reviewers point out friction points. It helps you identify areas that need improvement.

Example:

"The pricing page doesn't explain what's included in each plan. I had to click through to understand the difference between Pro and Enterprise. The export feature only supports CSV."

3. What Works?

What's good? What's well-designed? What solves the problem well?

This is similar to "What's Clear" but focuses on functionality. What features work as intended?

Example:

"The search is fast and accurate. The filtering options are comprehensive. The API documentation is excellent."

4. What to Improve?

What needs fixing? What's missing? What could be better?

This is where reviewers suggest improvements. It helps you prioritize features and fixes.

Example:

"Add keyboard shortcuts for power users. Support for dark mode would be nice. The mobile app is slow on older devices."

Quick Feedback

Quick feedback is shorter and less structured. It's useful for rapid feedback but earns fewer credits (+1 vs. +5).

Example:

"Love the design, but the mobile app is slow. Otherwise great product!"

Leaving Feedback

Step 1: Find a Product

Browse the Discover page and find a product you want to review.

Step 2: Click "Leave Feedback"

Click the "Leave feedback" button on the product page.

Step 3: Choose Your Format

Choose between structured feedback (5 credits) or quick feedback (1 credit).

Step 4: Write Your Feedback

For structured feedback, fill in all 4 dimensions. Be specific and actionable.

For quick feedback, write a short comment.

Step 5: Submit

Click "Submit" and wait for the maker to validate your feedback.

Managing Feedback (for Makers)

Viewing Feedback

Go to your product page and click the "Feedback" tab. You'll see all feedback submitted on your product.

Validating Feedback

When you validate feedback, the reviewer earns credits:

  • Structured feedback: +5 credits
  • Quick feedback: +1 credit
  • First structured feedback on your product: +10 bonus credits

Validation is your way of saying "this feedback is useful."

Dismissing Feedback

If feedback isn't useful, dismiss it. The reviewer earns nothing.

Dismissing feedback doesn't remove it from your product page — it just marks it as not validated.

Converting to Feature Requests

Feedback can be converted into feature requests. These appear on your public roadmap and community members can upvote them.

How to convert:

  1. Click on the feedback
  2. Click "Convert to Feature Request"
  3. Edit the title and description
  4. Click "Create"

The feature request is now on your public roadmap.

Custom Surveys

Beyond structured feedback, you can create custom surveys with your own questions.

Creating a Survey

  1. Go to your product page
  2. Click "Create Survey"
  3. Add your questions
  4. Set the credit reward per validated response
  5. Click "Publish"

Survey Types

Rating questions:

  • "How satisfied are you?" (1-5 scale)
  • "How likely are you to recommend us?" (1-10 scale)

Text questions:

  • "What could we improve?"
  • "What's your biggest pain point?"

Multiple choice:

  • "Which feature do you use most?"
  • "How did you hear about us?"

Embedding Surveys

Embed survey buttons on your site with 2 lines of HTML:

<script src="https://feedbackfirst.dev/widget.js" defer></script>

<ff-survey-button
  survey-id="survey-123"
  sso-token-url="/api/feedbackfirst/sso-token"
  label="Take survey"
></ff-survey-button>

See Embed Documentation for full details.

Feedback Analytics

Your workspace shows:

  • Total feedback received — Structured and quick
  • Validation rate — % of feedback you've validated
  • Average rating — If you use rating surveys
  • Common themes — Topics mentioned frequently

Best Practices for Reviewers

Be Specific

❌ "Good product" ✅ "The dashboard is intuitive, but the export feature only supports CSV. Adding JSON export would be helpful for developers."

Test the Product

Don't just skim the landing page. Actually use the product. Try the core features. Test the onboarding.

Be Constructive

Criticism is fine, but make it actionable. Don't just say what's wrong — suggest how to fix it.

Be Honest

Makers want honest feedback, not flattery. If something doesn't work, say so. But also acknowledge what works well.

Best Practices for Makers

Respond to Feedback

When reviewers leave feedback, acknowledge it. Let them know you're reading and considering their input.

Validate Useful Feedback

Validate feedback that's specific and actionable. Dismiss feedback that's vague or unhelpful.

Publish Updates

When you ship features based on feedback, publish an update and tag the original feedback. This creates a feedback loop and builds trust.

Engage with the Community

Don't just publish and wait. Review other products. Leave thoughtful feedback. Build your reputation.