This version of GitHub Enterprise Server was discontinued on 2024-09-25. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.

Restricting email notifications for your enterprise

You can prevent your enterprise's information from leaking into personal email accounts by restricting the domains where members can receive email notifications about activity in organizations owned by your enterprise.

Who can use this feature?

Enterprise owners can restrict email notifications for an enterprise.

Restriction of email notifications to approved or verified domains is available with GitHub Enterprise Cloud and GitHub Enterprise Server. For more information, see "GitHub’s plans."

In this article

About email restrictions for your enterprise

When you restrict email notifications, enterprise members can only use an email address in a verified or approved domain to receive email notifications about activity in organizations owned by your enterprise.

Note: The ability to approve a domain not owned by your organization or enterprise is currently in beta and subject to change.

The domains can be inherited from the enterprise or configured for the specific organization. For more information, see "Verifying or approving a domain for your enterprise" and "Restricting email notifications for your organization."

If email restrictions are enabled for an enterprise, organization owners cannot disable email restrictions for any organization owned by the enterprise. If changes occur that result in an organization having no verified or approved domains, either inherited from an enterprise that owns the organization or for the specific organization, email restrictions will be disabled for the organization.

Restricting email notifications for your enterprise

Before you can restrict email notifications for your enterprise, you must verify or approve at least one domain for the enterprise.

Users will not be notified when you enable email restrictions. It is your responsibility to inform users that, in the future, they will only receive email notifications related to your enterprise if they've added an email address belonging to a verified or approved domain to their account settings.

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. On the left side of the page, in the enterprise account sidebar, click Settings.

  3. Under "Settings", click Verified & approved domains.

  4. Under "Notification preferences", select Restrict email notifications to only approved or verified domains.

  5. Click Save.