Configuring notifications

Choose the type of activity on GitHub that you want to receive notifications for and how you want these updates delivered.

In this article

Notification delivery options

You can receive notifications for activity on GitHub in the following locations.

  • The notifications inbox in the GitHub web interface
  • The notifications inbox on GitHub Mobile, which syncs with the inbox in the web interface
  • An email client that uses a verified email address, which can also sync with the notifications inbox in the web interface and GitHub Mobile

To use the notifications inbox on GitHub and GitHub Mobile, you must enable notifications for both Email and On GitHub in your notification settings. For more information, see Choosing your notification settings.

Tip

If you receive notifications both via email and on GitHub, you can automatically sync the read or unread status of the notification so that notifications on GitHub are automatically marked as read once you've read the corresponding email notification. To enable this sync, your email client must be able to view images from notifications@github.com.

Benefits of the notifications inbox

The notifications inbox includes triaging options designed specifically for your GitHub notifications flow, including options to:

  • Triage multiple notifications at once.
  • Mark completed notifications as Done and remove them from your inbox. To view all of your notifications marked as Done, use the is:done query.
  • Save a notification to review later. Saved notifications are flagged in your inbox and kept indefinitely. To view all of your saved notifications, use the is:saved query.
  • Unsubscribe and remove a notification from your inbox.
  • Preview the issue or pull request where the notification originates on GitHub from within the notifications inbox.
  • See one of the latest reasons you're receiving a notification from your inbox with a reasons label.
  • Create custom filters to focus on different notifications when you want.
  • Group notifications in your inbox by repository or date to get a quick overview with less context switching.

In addition, you can receive and triage notifications on your mobile device with GitHub Mobile. For more information, see Managing your notification settings with GitHub Mobile or GitHub Mobile.