See updates on the important activities you're interested in. Notifications can be viewed on GitHub or in an email.

Types of notifications

GitHub delivers two kinds of notifications:

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

    • Someone @mentions you or a team you're a member of
    • You are assigned to an issue or pull request
    • Someone makes a comment in a conversation you're subscribed to
  • Watching notifications are those in which you are are actively watching a repository, but aren't necessarily participating. You will automatically receive these notifications for:

    • Opened issues and their comments
    • Opened pull requests and their comments
    • Comments on any commits
    • Published releases

Note: You will not get notifications for your own actions.

Notification indicator

In the upper-left corner of any page, there's a symbol that indicates not only whether you have a notification, but also what type of notification it is.

Notification state Notification icon Image
An unread notification exists for any repository across GitHub The notification indicator is a blue dot Notification indicating any unread message
An unread notification exists specifically for the repository you are on The notification indicator has a blue background as well Notification indicating an unread message for the repository you are looking at
You have no notifications There is no blue dot Notification indicating with no unread messages

Configuring notification delivery methods

You can choose how different notifications are delivered to you--whether they're available only on GitHub, sent as emails, or both. For more information, see "Configuring notification delivery methods."

Further reading