To verify domains on GitHub, you must have owner permissions in the organization. For more information, see "Permission levels for an organization." You will also need access to modify domain records with your domain hosting service.
After verifying ownership of your organization's domains, a "Verified" badge will display on the organization's profile. If your organization is on GitHub Enterprise Cloud and has agreed to the Corporate Terms of Service, organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. For more information, see "About your organization's profile page" and "Upgrading to the Corporate Terms of Service."
If your organization is owned by an enterprise account, a "Verified" badge will display on your organization's profile for any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "Verifying your enterprise account's domain."
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
www.example.com and the email address
firstname.lastname@example.org, you would need to verify both
On GitHub Enterprise Cloud, after verifying ownership of your organization's domain, you can restrict email notifications for the organization to that domain. For more information, see "Restricting email notifications to an approved domain."
- In the top right corner of GitHub, click your profile photo, then click Your organizations.
- Click Settings next to the organization.
- In the left sidebar, click Verified domains.
- Click Add a domain.
- In the domain field, type the domain you'd like to verify, then click Add domain.
- Follow the instructions under Add a DNS TXT record to create a DNS TXT record with your domain hosting service.
- 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
digcommand on the command line, replacing
ORGANIZATIONwith the name of your organization and
example.comwith the domain you'd like to verify. You should see your new TXT record listed in the command output.
$ dig _github-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT
- After confirming your TXT record is added to your DNS, navigate to the Verified domains tab in your organization's settings. You can follow steps one through four above to locate the Verified domains tab.
- To the right of the domain that's pending verification, click , then click Continue verifying.
- Click Verify domain.
- Optionally, once the "Verified" badge is visible on your organization's profile page, you can delete the TXT entry from the DNS record at your domain hosting service.