Without PushFeedback
- Page views without an explanation
- Feedback spread across support and chat
- No page context for reader comments
- No clear signal after a rewrite
Feedback widget for documentation
See which docs pages need work
Collect page ratings, comments, and optional annotated screenshots. See which pages need attention and why readers got stuck.
Free for one site. No credit card. 22 documented setup paths.
docs.yourcompany.com/api/auth
Authentication
POST /v1/auth/token
Authorization: Bearer ...
Share your feedback
Powered by PushFeedback
Was this page helpful?
The token example doesn't show how to refresh it...
Email address (optional)
Used on 200+ documentation sites
Traffic shows what readers opened.
Feedback shows what needs work.
Page views do not tell you whether a reader found the answer. Page-level ratings and comments show which pages need attention and whether a rewrite helped. See five ways to measure docs quality →
With PushFeedback
- Ratings and comments tied to each page
- Optional annotated screenshots for visual context
- Suggested themes for your team to review
- Trends to compare before and after an update
What you can reviewPage-level signals for
Page-level signals for
docs reviews.
/01
Pages that may need attention
Sort documentation pages by negative feedback, sentiment trend, or volume.
This week · negative ▼
1/api/auth/refresh-tokens
2/guides/installation
3/api/webhooks/setup
4/tutorials/quickstart
/02
Comments and screenshots
Readers explain the issue and can annotate the area they want you to review.
“This step assumes I already created an API key. Where do I do that?”
Anna · 2h ago
/03
Suggested feedback themes
AI suggests recurring themes, surfaces sentiment shifts, and proposes actions for your team to review.
Auth examples missing refresh logic23 mentions
Mobile screenshots out of date18 mentions
Webhook setup unclear after step 412 mentions
+ 4 more themes→
/04
A widget that fits your docs
Match your brand colors, position, and theme. Use an inline or floating placement.
Pick a color, then open the widget to see it live.
Integrations
Fits your docs stack and review workflow.
Install PushFeedback on your documentation site, then review feedback in the dashboard or send it to the tools your team already uses.
Documentation tools
Install the widget with a documented setup path.
Issue trackers and management tools
Create work from feedback that needs follow-up.
Team notifications
Send new feedback to the channels your team watches.
Webhooks and automation
Connect custom destinations and automated workflows.
AI ReportsStart with a feedback summary.
Start with a feedback summary.
Review the source.
Run a report whenever you need one: top themes with mention counts, representative quotes, and suggested fixes for a senior technical writer to review.
Sample AI report · Mar 17 - Mar 24
312 feedback entries · 5 suggested themes · 4 suggested actions
Sentiment
+12%
Top recurring themes
P1
Auth examples missing refresh-token logic
23 mentions · /api/auth/* · sentiment: negative
P1
Mobile screenshots out of date
18 mentions · /guides/* · sentiment: negative
P2
Webhook setup unclear after step 4
12 mentions · /api/webhooks · sentiment: mixed
Suggested actions
Add refresh token example to /api/auth/tokens. The most mentioned issue this period, with 23 related comments.
Update 6 mobile screenshots in /guides/installation. Last refresh: 14 months ago.
Rewrite step 4-6 of webhook setup. Most users dropped feedback at step 5.
Illustrative data. AI-generated themes and suggested actions require human review.
See a sample AI reportBuilt for the docs teamWhatever you write,
Whatever you write,
find what needs clarification.
API DOCS
Endpoints, examples, errors
Find endpoints that need examples, auth flows that need context, and error responses that need explanation.
"This endpoint returns 404"
"The authentication example doesn't work"
USER GUIDES
Steps, screenshots, assumptions
Spot screenshots that no longer match the UI, missing steps, and instructions that assume too much.
"This screenshot doesn't match my interface"
"Step 4 is missing"
TUTORIALS
Where readers get stuck
See where readers need more context, which prerequisites are missing, and which sections need more depth.
"I got stuck at this part"
"This assumes I know Y"
Frequently asked questions
You can. A basic form is straightforward. PushFeedback adds the dashboard, screenshots, reporting, integrations, privacy controls, and ongoing maintenance.
The widget loads asynchronously. As with any third-party script, test it against your own performance budget and Core Web Vitals before rolling it out broadly.
It does not expire. It includes one site, one seat, unlimited submissions, and access to all text feedback in the dashboard. The first 25 submissions are emailed to you, followed by a monthly summary.
Usually not. PushFeedback has 22 documented setup paths, including Docusaurus, MkDocs, Sphinx, Next.js, React, and WordPress.
PushFeedback supports consent controls, data export, deletion requests, and optional EU-hosted infrastructure. See the security and privacy documentation for details relevant to your setup.
See which docs pages need work. Start with reader feedback.
Add the widget and collect ratings, comments, and optional annotated screenshots from each page.
- Free for one site
- No credit card
- Cancel anytime