Skip to content

Commit 905b8cb

Browse files
author
mydickassbusiness
authored
Clean up domain verification documentation
Removed introductory metadata and sections about domain verification for GitHub Pages.
1 parent 1f077aa commit 905b8cb

1 file changed

Lines changed: 1 addition & 47 deletions

File tree

content/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages.md

Lines changed: 1 addition & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,4 @@
1-
---
2-
title: Verifying your custom domain for GitHub Pages
3-
intro: You can increase the security of your custom domain and avoid takeover attacks by verifying your domain.
4-
product: '{% data reusables.gated-features.pages %}'
5-
versions:
6-
fpt: '*'
7-
ghec: '*'
8-
shortTitle: Verify a custom domain
9-
category:
10-
- Managing a GitHub Pages site
11-
---
12-
13-
## About domain verification for GitHub Pages
14-
15-
When you verify a custom domain for your personal account, only repositories owned by your personal account may be used to publish a {% data variables.product.prodname_pages %} site to the verified custom domain or the domain's immediate subdomains. Similarly, when you verify a custom domain for your organization, only repositories owned by that organization may be used to publish a {% data variables.product.prodname_pages %} site to the verified custom domain or the domain's immediate subdomains.
16-
17-
Verifying your domain stops other GitHub users from taking over your custom domain and using it to publish their own {% data variables.product.prodname_pages %} site. Domain takeovers can happen when you delete your repository, when your billing plan is downgraded, or after any other change which unlinks the custom domain or disables {% data variables.product.prodname_pages %} while the domain remains configured for {% data variables.product.prodname_pages %} and is not verified.
18-
19-
When you verify a domain, any immediate subdomains are also included in the verification. For example, if the `github.com` custom domain is verified, `docs.github.com`, `support.github.com`, and any other immediate subdomains will also be protected from takeovers.<!-- markdownlint-disable-line search-replace -->
20-
21-
{% data reusables.pages.wildcard-dns-warning %}
22-
23-
It's also possible to verify a domain for your organization{% ifversion ghec %} or enterprise{% endif %}, which displays a "Verified" badge on the organization {% ifversion ghec %}or enterprise{% endif %} profile{% ifversion ghec %} and, on {% data variables.product.prodname_ghe_cloud %}, allows you to restrict notifications to email addresses using the verified domain{% endif %}. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization){% ifversion ghec %} and [AUTOTITLE](/enterprise-cloud@latest/admin/configuring-settings/configuring-user-applications-for-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise){% endif %}.
24-
25-
### Verifying a domain that is already taken
26-
27-
You may be verifying a domain you own, which is currently in use by another user or organization, to make it available for your {% data variables.product.prodname_pages %} website. In this case, the domain will be immediately released from {% data variables.product.prodname_pages %} websites which are owned by other users or organizations. If you are attempting to verify an already verified domain (verified by another user or organization), the release process will not be successful.
28-
29-
## Verifying a domain for your user site
30-
31-
> [!NOTE]
32-
> If you don’t see the options described below, make sure you’re in your **Profile settings**, not your repository settings. Domain verification happens at the profile level.
33-
34-
{% data reusables.user-settings.access_settings %}
35-
1. {% data reusables.user-settings.code-planning-automation %} click **{% octicon "browser" aria-hidden="true" aria-label="browser" %} Pages**.
36-
{% data reusables.pages.settings-verify-domain-setup %}
37-
1. Wait for your DNS configuration to change, this may be immediate or take up to 24 hours. You can confirm the change to your DNS configuration by running the `dig` command on the command line. In the command below, replace `USERNAME` with your username and `example.com` with the domain you're verifying. If your DNS configuration has updated, you should see your new TXT record in the output.
38-
39-
```text
40-
dig _github-pages-challenge-USERNAME.example.com +nostats +nocomments +nocmd TXT
41-
```
42-
43-
{% data reusables.pages.settings-verify-domain-confirm %}
44-
45-
## Verifying a domain for your organization site
46-
47-
Organization owners can verify custom domains for their organization.
1+
.
482

493
> [!NOTE]
504
> If you don’t see the options described below, check that you’re in your **Organization settings**. Domain verification doesn’t take place in repository settings.

0 commit comments

Comments
 (0)