About email notifications for pushes to your repository

You can choose to automatically send email notifications to a specific email address when anyone pushes to the repository.

Who can use this feature?

People with admin permissions in a repository can enable email notifications for pushes to your repository.

In this article

Each email notification for a push to a repository lists the new commits and links to a diff containing just those commits. In the email notification you'll see:

  • The name of the repository where the commit was made
  • The branch a commit was made in
  • The SHA1 of the commit, including a link to the diff in GitHub
  • The author of the commit
  • The date when the commit was made
  • The files that were changed as part of the commit
  • The commit message

You can filter email notifications you receive for pushes to a repository. For more information, see "Configuring notifications."

Enabling email notifications for pushes to your repository

  1. On GitHub, navigate to the main page of the repository.

  2. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. In the "Integrations" section of the sidebar, click Email notifications.

  4. In the "Address" field, type up to two email addresses, separated by whitespace, where you'd like notifications to be sent. If you'd like to send emails to more than two accounts, set one of the email addresses to a group email address.

  5. If you operate your own server, you can verify the integrity of emails via the "Approved header." The "Approved header" is a token or secret that you type in this field, and that is sent with the email. If the Approved header of an email matches the token, you can trust that the email is from GitHub.

  6. Click Setup notifications.

Further reading