Managing disruptive comments

Hiding a comment

Anyone with write access to a repository, can hide comments on issues, pull requests, and commits.

If a comment is off-topic, outdated, or resolved, you may want to hide a comment to keep a discussion focused or make a pull request easier to navigate and review. Hidden comments are minimized but people with read access to the repository can expand them.

Screenshot of a hidden comment. The only visible content is "This comment has been minimized", with a button to show the comment.

Navigate to the comment you'd like to hide.
In the upper-right corner of the comment, click , then click Hide.
Using the "Choose a reason" dropdown menu, choose a reason to hide the comment. Then select Hide comment.

Unhiding a comment

Anyone with write access to a repository, can unhide comments on issues, pull requests, and commits.

Navigate to the comment you'd like to unhide.
On the right side of the comment, click Show comment.
On the right side of the expanded comment, select the dropdown menu, then click Unhide.

Editing a comment

Anyone with write access to a repository can edit comments on issues, pull requests, and commits.

It's appropriate to edit a comment and remove content that doesn't contribute to the conversation and violates your community's code of conduct.

Sometimes it may make sense to clearly indicate edits and their justification.

That said, anyone with read access to a repository can view a comment's edit history. The edited dropdown at the top of the comment contains a history of edits showing the user and timestamp for each edit.

Screenshot of a comment by octo-user, which has been partially redacted. In the comment header, next to the text "edited by octocat", a dropdown icon is outlined in orange.

Redacting sensitive information

Comment authors and anyone with write access to a repository can also delete sensitive information from a comment's edit history. For more information, see "Tracking changes in a comment."

Navigate to the comment you'd like to edit.
In the upper-right corner of the comment, click , then click Edit.
In the comment window, delete the content you'd like to remove, then type [REDACTED] to replace it.
At the bottom of the comment, type a note indicating that you have edited the comment, and optionally, why you edited the comment.
Click Update comment.

Deleting a comment

Anyone with write access to a repository can delete comments on issues, pull requests, and commits. Organization owners, team maintainers, and the comment author can also delete a comment on a team page.

If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead.

Deleting a comment is your last resort as a moderator. It's appropriate to delete a comment if the entire comment adds no constructive content to a conversation and violates your community's code of conduct.

Deleting a comment creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who deleted the comment is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized.

Screenshot of a timeline event, which says "octo-org deleted a comment from hubot 6 minutes ago."

Note

The initial comment (or body) of an issue or pull request can't be deleted. Instead, you can edit issue and pull request bodies to remove unwanted content.

Steps to delete a comment

Navigate to the comment you'd like to delete.
In the upper-right corner of the comment, click , then click Delete.
Optionally, write a comment noting that you deleted a comment and why.