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 public preview 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.

To continue receiving email notifications after you enable restrictions, members must verify any email addresses within domains that you verify or approve. For more information, see "Verifying your email address."

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. For more information, see Verifying or approving a domain for your 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, click your profile photo.
  2. Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
  3. On the left side of the page, in the enterprise account sidebar, click Settings.
  4. Under "Settings", click Verified & approved domains.
  5. Under "Notification preferences", select Restrict email notifications to only approved or verified domains.
  6. Click Save.