Verifying your enterprise account's domain

You can confirm the identity of organizations owned by your enterprise account by verifying ownership of your domain names with GitHub.

Enterprise owners can verify an enterprise account's domain.

Enterprise accounts are available with GitHub Enterprise Cloud and GitHub Enterprise Server. For more information, see "About enterprise accounts."

In this article

About domain verification

You can confirm that the websites and email addresses listed on the profiles of any organization owned by your enterprise account are controlled by your enterprise by verifying the domains. Verified domains for an enterprise account apply to every organization owned by the enterprise account, and organization owners can verify additional domains for their organizations. For more information, see "Verifying your organization's domain."

After you verify ownership of your enterprise account's domains, a "Verified" badge will display on the profile of each organization that has the domain listed on its profile. To display a "Verified" badge, the website and email information shown on an organization's profile must match the verified domain or domains. If the website and email address shown on your organization's profile are hosted on different domains, you must verify both domains. If the website and email address use variants of the same domain, you must verify both variants. For example, if the profile shows the website and the email address, you would need to verify both and

Organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain.

After you verify domains for your enterprise account, you can restrict email notifications to verified domains for all the organizations owned by your enterprise account. For more information, see "Restricting email notifications for your enterprise account to approved domains."

Even if you don't restrict email notifications for the enterprise account, if an organization owner has restricted email notifications for the organization, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information about restricting notifications for an organization, see "Restricting email notifications to an approved domain."

Verifying your enterprise account's domain

To verify your enterprise account's domain, you must have access to modify domain records with your domain hosting service.

  1. In the top-right corner of GitHub, click your profile photo, then click Your enterprises. "Your enterprises" in drop-down menu for profile photo on GitHub

  2. In the list of enterprises, click the enterprise you want to view. Name of an enterprise in list of your enterprises

  3. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  4. Under "Settings", click Verified domains. "Verified domains" tab

  5. Click Add a domain. Add a domain button

  6. In the domain field, type the domain you'd like to verify, then click Add domain. Add a domain field

  7. Follow the instructions under Add a DNS TXT record to create a DNS TXT record with your domain hosting service. Instructions to create a DNS txt record

  8. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the dig command on the command line, replacing ENTERPRISE-ACCOUNT with the name of your enterprise account, and with the domain you'd like to verify. You should see your new TXT record listed in the command output.

    dig +nostats +nocomments +nocmd TXT
  9. To the right of the domain that's pending verification, click , then click Continue verifying. Continue verifying domain button

  10. Click Verify domain. Verify domain button

  11. Optionally, after the "Verified" badge is visible on your organizations' profiles, delete the TXT entry from the DNS record at your domain hosting service. Verified badge

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.