Comment on pages in the editor
Leave inline comments on pages in the editor to give feedback, ask questions, mention teammates, and resolve threads before you publish changes.
Comments let you and your team leave feedback on specific text in a page without editing the content. Use comments to ask questions, flag issues, or discuss changes before you publish them.
Comments live only inside the editor. They are never included in the published site or committed to your repository.
All roles—viewers, editors, and admins—can leave and reply to comments. Only editors and admins can resolve comment threads.
If your branch has an open pull request, Mintlify adds a summary of unresolved comment threads to the pull request description. The summary lists the files with open comments, the first comment in each thread, and a link to navigate to the comment in the editor.
The summary updates when you add, resolve, or delete a comment.
Add a comment
- Highlight the text you want to comment on.
- Click the Comment icon in the toolbar.
- Type your comment and press Enter to submit.
Reply to a comment
To open a comment thread, click the highlighted text or click the thread in the comment sidebar. Type your reply and press Enter to submit.
Mention a teammate
Type @ in a comment or reply to mention a teammate. People must be a member of your organization for you to mention them.
Mentioned teammates receive an email notification.
Resolve a comment
Editors and admins can resolve threads when a discussion is complete.
Click the checkmark icon to resolve a thread. Resolved threads are removed from the comment sidebar and the highlight is cleared from the page.
Delete a comment
Click the trashcan icon beside a comment to delete it. Deleting the first comment in a thread deletes the entire thread.
You can delete your own comments. Admins can delete any comment.