Skip to main content

Managing disruptive comments

You can hide, edit, or delete comments on issues, pull requests, and commits.

Hiding a comment

Organization moderators, and 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.

  1. Navigate to the comment you'd like to hide.

  2. In the upper-right corner of the comment, click , then click Hide. The horizontal kebab icon and comment moderation menu showing the edit, hide, delete options

  3. Using the "Choose a reason" drop-down menu, click a reason to hide the comment. Then click, Hide comment.

    Choose reason for hiding comment drop-down menu

Unhiding a comment

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

  1. Navigate to the comment you'd like to unhide.
  2. On the right side of the comment, click Show comment.
  3. On the right side of the expanded comment, select the dropdown menu, then click Unhide. The horizontal kebab icon and comment moderation menu showing the edit, unhide, delete options

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 or GitHub's Community Guidelines.

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.

Comment with added note that content was redacted

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."

  1. Navigate to the comment you'd like to edit.

  2. In the upper-right corner of the comment, click , then click Edit.

    The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options

  3. In the comment window, delete the content you'd like to remove, then type [REDACTED] to replace it.

  4. At the bottom of the comment, type a note indicating that you have edited the comment, and optionally, why you edited the comment.

  5. 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 or GitHub's Community Guidelines.

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

  1. Navigate to the comment you'd like to delete.
  2. In the upper-right corner of the comment, click , then click Delete. The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options
  3. Optionally, write a comment noting that you deleted a comment and why.

Further reading