Collect page feedback from users and AI agents

The Feedback section of the analytics page displays thumbs-up and thumbs-down ratings for your pages and the written feedback that users and AI agents submit. Use this information to gauge the quality of your content and make improvements. The Feedback section has two cards:

• Page ratings: Thumbs-up and thumbs-down ratings from users, grouped by page.
• Detailed feedback: Feedback that includes written content, such as comments, code snippet feedback, and agent feedback.

Filter the Feedback section by time period or by page or path. The Feedback total in the Traffic view counts all page feedback in the selected time period, including thumbs ratings, code snippet feedback, and agent feedback. Ratings on assistant responses are tracked separately as satisfaction in the Assistant view and do not count toward feedback totals. Review your feedback data to:

• Identify successful content: Pages with the most positive feedback show what works well in your documentation.
• Prioritize improvements: Pages with the most negative feedback indicate what content might need attention.
• Take action: Make documentation updates based on direct user feedback.

​

Enable feedback

To collect and view feedback from users, you must enable feedback in the Feedback section of the General settings page in your dashboard.

1. Navigate to the General settings page.
2. In the Feedback section, enable your desired feedback types.

• Thumbs rating: Simple thumbs up/down voting to gauge overall satisfaction with pages.
• Edit suggestions: Allow users to suggest edits to your documentation. Only available for public repositories.
• Raise issues: Allow users to create issues directly from your site. Only available for public repositories.
• Contextual feedback: Free-form feedback about the content of a page. Optionally, enable email collection to allow users to provide their email address when submitting feedback.
• Code snippet feedback: Feedback specifically on code snippets.

​

Review feedback

​

Page ratings

The Page ratings card lists pages with their thumbs-up and thumbs-down counts. Sort by Most negative or Most positive to find the pages that users find least and most helpful. Thumbs ratings also count as actions in the User engagements view.

​

Detailed feedback

The Detailed feedback card lists feedback that includes additional information. Submissions that use only the thumbs up or thumbs down rating without a comment appear in Page ratings, not in Detailed feedback. Use the filter menu to narrow the list:

• Sentiment: Show feedback rated positively, negatively, or both.
• Type: Show Comments, Agent feedback, Code blocks, or any combination.

Select a piece of feedback to view its details, including the page, type, and date. To analyze feedback outside the dashboard, export it to CSV.

​

Dismiss feedback

Dismiss feedback that is irrelevant or inaccurate. Select Dismiss from a piece of feedback’s menu or from its details panel. Dismissed feedback no longer appears in the Detailed feedback card.

​

Agent feedback

Third-party AI agents can submit structured feedback about pages they find incorrect, outdated, or difficult to use. This feedback appears in the Detailed feedback card. To show only agent feedback, select Agent feedback in the Type filter. All other feedback in the Feedback section comes from human users. Manage agent feedback the same way as human feedback.

​

How agent feedback works

Connect an agent to your site’s search MCP server. The server exposes a submit_feedback tool that requires the page path and a description of the problem. The path must match a page on your site or the source of one of your redirects. You can pass a relative path or a full URL. Query strings, fragments, .md and .mdx extensions, and your site’s base path don’t affect matching. If no page matches, the submit_feedback tool returns an error and the submission isn’t recorded. Mintlify records each accepted submission as unhelpful feedback for the specified page. The feedback appears in the dashboard alongside human feedback.

​

Retrieve agent feedback via API

Use the analytics feedback endpoint to retrieve agent feedback programmatically. Filter by source=agent to return only agent feedback. Agent feedback responses include:

• comment: The feedback text submitted by the agent.
• path: The path of the page the feedback is about.