See updates about the important activities you're interested in. You can view notifications on GitHub or in an email.

Types of notifications

GitHub delivers two kinds of notifications:

  • Participating notifications are those in which you're directly involved in a conversation. You'll automatically receive these notifications when:

    • Someone mentions you or a team you're a member of
    • Someone mentions the parent team of a child team you're a member of
    • You're assigned to an issue or pull request
    • Someone makes a comment in a conversation you're subscribed to
    • Someone makes a commit to a pull request you're subscribed to
    • You open, comment on, or close an issue or pull request
    • Someone submits a review approving or requesting changes to a pull request you're subscribed to
    • Someone requests that you, or a team you're a member of, review a pull request.
    • You, or a team you're a member of, are the designated owner of a file and someone opens a pull request that changes that file.
  • Watching notifications are those in which you're actively watching a repository, but aren't necessarily participating. You'll automatically receive these notifications for:

    • Opened issues and their comments
    • Opened pull requests and their comments
    • Comments on any commits
    • Published releases
    • Submitted reviews approving or requesting changes to a pull request.

Shared read state

If you read a notification email, it can automatically be marked as read in your web notifications on GitHub as well. To enable the shared read state, you must allow viewing images from notifications@github.com.

Managing notification delivery methods

You can choose to receive notifications on GitHub, via email, or both. You can also choose which type of email updates you'd like to receive on conversations you're participating in or watching. For more information, see "Managing notification delivery methods."

Further reading