Skip to main content

Configuring notifications in GitHub Desktop

GitHub Desktop will keep you up-to-date with notifications about events that occur in your pull request branch.

About notifications in GitHub Desktop

GitHub Desktop will show a system notification for events that occur in the currently selected repository. Notifications will be shown when:

  • Pull request checks have failed.
  • A pull request review is left with a comment, approval, or requested changes.

Clicking the notification will switch application focus to GitHub Desktop and provide more detailed information.

Notifications about pull request check failures

When changes are made to a pull request branch, you will receive a notification if the checks fail.

pull request checks failed notification

Clicking the notification will display a dialog with details about the checks. Once you've reviewed why the checks have failed, you can re-run the checks, or quickly switch to the pull request branch to get started on fixing the errors. For more information, see "Viewing and re-running checks in GitHub Desktop."

checks failed dialog

Notifications for pull request reviews

GitHub Desktop will surface a system notification when a teammate has approved, commented, or requested changes in your pull request. See "About pull request reviews" for more information on pull request reviews.

Pull request review notification

Clicking the notification will switch application focus to GitHub Desktop and provide more context for the pull request review comment.

pull request review dialog

Enabling notifications

If system notifications are disabled for GitHub Desktop you can follow the steps below to enable them.

  1. Click the Apple menu, then select System Preferences.
  2. Select Notifications & Focus.
  3. Select GitHub Desktop from the list of applications.
  4. Click Allow Notifications.

macOS Notifications & Focus

For more information about macOS system notifications, see "Use notifications on your Mac."

  1. Open the Start menu, then select Settings.
  2. Select System, then click Notifications.
  3. Find GitHub Desktop in the application list and click On.

Enable Windows Notifications

For more information about Windows system notifications, see "Change notification settings in Windows."