Han Wang
Co-Founder
Share this article

Launch Week Day 2 introduced Docs Feedback, a simple thumbs up/down rating system that allows users to provide direct feedback on documentation pages. This feature helps teams identify underperforming pages, content gaps, and improvement opportunities while integrating with analytics platforms like PostHog to track usage and user satisfaction.
Day 2 of Launch Week brings Docs Feedback to your documentation.
Simple to use and intuitive in design, this new feature is the easiest way for you to create a direct channel for gathering feedback from your users 👍👎
With Docs Feedback, users upvote or downvote the helpfulness of a page and you can access that feedback right in your analytics.
Why it matters
Documentation is a powerful leverage for improving conversions and boosting customer success, but only if you can understand what your users are looking for and whether they can find what they need.
The best way to collect that information? By setting up a direct channel for user response.
With Docs Feedback, you can now easily identify which pages are underperforming, where there are gaps in content, and how to improve them.
On the analytics side, Posthog makes it exceptionally easy for you to track usage and feedback for their own products. At Mintlify, we use Posthog for our own product, and we love how the platform can do wonders for you, too.
Getting started
To get Docs Feedback, simply enable documentation feedback in your mint.json file like so
"feedback": {
"thumbsRating": true
}
You can also enable your doc viewers to open Github issues and open PRs to suggest edits (for public repos)
"feedback": {
"suggestEdit": true,
"raiseIssue": true
}
Check it out
You can see our Docs Feedback in action at the bottom of all of our pages, like here.
Here's a sneak peak of our own internal analytics from Docs Feedback, with our most helpful pages measured by number of upvotes versus downvotes.
Follow our Twitter or join the community to stay tuned for more!
More blog posts to read

How Mintlify uses Claude Code as a technical writing assistant
As the sole technical writer at Mintlify, I'm always looking for ways to improve my workflows and empower other people on my team to contribute to the docs. I also want to take a vacation without blocking docs ships for a week and a half.
August 19, 2025Ethan Palm
Technical Writing

AI Documentation Trends: What's Changing in 2025
Coming into 2025, there were a number of predictions as to how AI would impact what we do and how we do it. And just halfway through the year, those predictions are already reshaping our daily tools and practices faster than anyone expected, across nearly every domain.
August 6, 2025Emma Adler
Contributor @ Hackmamba
Han Wang
Co-Founder